Enumerable.MaxBy Método

Definição

Namespace:

System.Linq

Assembly:

System.Linq.dll

Sobrecargas

MaxBy<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>)	Retorna o valor máximo em uma sequência genérica de acordo com uma função de seletor de chave especificada.
MaxBy<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>, IComparer<TKey>)	Retorna o valor máximo em uma sequência genérica de acordo com uma função de seletor de chave e um comparador de chave especificados.

MaxBy<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>)

Origem:

Max.cs

Retorna o valor máximo em uma sequência genérica de acordo com uma função de seletor de chave especificada.

public:
generic <typename TSource, typename TKey>
[System::Runtime::CompilerServices::Extension]
 static TSource MaxBy(System::Collections::Generic::IEnumerable<TSource> ^ source, Func<TSource, TKey> ^ keySelector);

public static TSource? MaxBy<TSource,TKey> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,TKey> keySelector);

static member MaxBy : seq<'Source> * Func<'Source, 'Key> -> 'Source

<Extension()>
Public Function MaxBy(Of TSource, TKey) (source As IEnumerable(Of TSource), keySelector As Func(Of TSource, TKey)) As TSource

Parâmetros de tipo

TSource

O tipo dos elementos de source.

TKey

O tipo de chave pelo qual comparar elementos.

Parâmetros

source

IEnumerable<TSource>

Uma sequência de valores para determinação do valor máximo.

keySelector

Func<TSource,TKey>

Uma função para extrair a chave de cada elemento.

Retornos

TSource

O valor com a chave máxima na sequência.

Exceções

ArgumentNullException

source é null.

ArgumentException

Nenhuma chave extraída de source implementa a IComparable interface ou IComparable<T> .

InvalidOperationException

TSource é um tipo primitivo e a sequência de origem está vazia.

Comentários

Se a sequência de origem estiver vazia, dois resultados possíveis serão possíveis dependendo do tipo de origem. Se TSource for um tipo que permite valor nulo, esse método retornará null. Se TSource for um struct não anulável, como um tipo primitivo, um InvalidOperationException será gerado.

Se a sequência de origem contiver apenas valores que são null, esse método retornará null.

MaxBy<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>, IComparer<TKey>)

Origem:

Max.cs

Retorna o valor máximo em uma sequência genérica de acordo com uma função de seletor de chave e um comparador de chave especificados.

public:
generic <typename TSource, typename TKey>
[System::Runtime::CompilerServices::Extension]
 static TSource MaxBy(System::Collections::Generic::IEnumerable<TSource> ^ source, Func<TSource, TKey> ^ keySelector, System::Collections::Generic::IComparer<TKey> ^ comparer);

public static TSource? MaxBy<TSource,TKey> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,TKey> keySelector, System.Collections.Generic.IComparer<TKey>? comparer);

static member MaxBy : seq<'Source> * Func<'Source, 'Key> * System.Collections.Generic.IComparer<'Key> -> 'Source

<Extension()>
Public Function MaxBy(Of TSource, TKey) (source As IEnumerable(Of TSource), keySelector As Func(Of TSource, TKey), comparer As IComparer(Of TKey)) As TSource

Parâmetros de tipo

TSource

O tipo dos elementos de source.

TKey

O tipo de chave pelo qual comparar elementos.

Parâmetros

source

IEnumerable<TSource>

Uma sequência de valores para determinação do valor máximo.

keySelector

Func<TSource,TKey>

Uma função para extrair a chave de cada elemento.

comparer

IComparer<TKey>

O IComparer<T> para comparar chaves.

Retornos

TSource

O valor com a chave máxima na sequência.

Exceções

ArgumentNullException

source é null.

ArgumentException

Nenhuma chave extraída de source implementa a IComparable interface ou IComparable<T> .

InvalidOperationException

TSource é um tipo primitivo e a sequência de origem está vazia.

Comentários

Se a sequência de origem estiver vazia, dois resultados possíveis serão possíveis dependendo do tipo de origem. Se TSource for um tipo que permite valor nulo, esse método retornará null. Se TSource for um struct não anulável, como um tipo primitivo, um InvalidOperationException será gerado.

Se a sequência de origem contiver apenas valores que são null, esse método retornará null.