MoreEnumerableMaxByTSource, TKey Method (IEnumerableTSource, FuncTSource, TKey, IComparerTKey) |
Returns the maximal elements of the given sequence, based on
the given projection and the specified comparer for projected values.
Namespace:
MoreLinq
Assembly:
MoreLinq (in MoreLinq.dll) Version: 3.3.1+b77df70598ab84c28cd43dcf74594024b6d575e1
Syntax public static IExtremaEnumerable<TSource> MaxBy<TSource, TKey>(
this IEnumerable<TSource> source,
Func<TSource, TKey> selector,
IComparer<TKey> comparer
)
<ExtensionAttribute>
Public Shared Function MaxBy(Of TSource, TKey) (
source As IEnumerable(Of TSource),
selector As Func(Of TSource, TKey),
comparer As IComparer(Of TKey)
) As IExtremaEnumerable(Of TSource)
public:
[ExtensionAttribute]
generic<typename TSource, typename TKey>
static IExtremaEnumerable<TSource>^ MaxBy(
IEnumerable<TSource>^ source,
Func<TSource, TKey>^ selector,
IComparer<TKey>^ comparer
)
[<ExtensionAttribute>]
static member MaxBy :
source : IEnumerable<'TSource> *
selector : Func<'TSource, 'TKey> *
comparer : IComparer<'TKey> -> IExtremaEnumerable<'TSource>
Parameters
- source
- Type: System.Collections.GenericIEnumerableTSource
Source sequence - selector
- Type: SystemFuncTSource, TKey
Selector to use to pick the results to compare - comparer
- Type: System.Collections.GenericIComparerTKey
Comparer to use to compare projected values
Type Parameters
- TSource
- Type of the source sequence
- TKey
- Type of the projected element
Return Value
Type:
IExtremaEnumerableTSourceThe maximal element, according to the projection.
Usage Note
In Visual Basic and C#, you can call this method as an instance method on any object of type
IEnumerableTSource. When you use instance method syntax to call this method, omit the first parameter. For more information, see
Extension Methods (Visual Basic) or
Extension Methods (C# Programming Guide).
Exceptions Exception | Condition |
---|
ArgumentNullException | source, selector
or comparer is null |
Remarks
This operator uses deferred execution. The results are evaluated
and cached on first use to returned sequence.
See Also