Enumerable.MaxBy Метод

Определение

Пространство имен:

System.Linq

Сборка:

System.Linq.dll

Перегрузки

MaxBy<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>)	Возвращает максимальное значение в универсальной последовательности в соответствии с указанной функцией селектора ключей.
MaxBy<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>, IComparer<TKey>)	Возвращает максимальное значение в универсальной последовательности в соответствии с указанной функцией селектора ключей и компратором ключей.

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

Исходный код:

Max.cs

Возвращает максимальное значение в универсальной последовательности в соответствии с указанной функцией селектора ключей.

C#

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

Параметры типа

TSource

Тип элементов source.

TKey

Тип ключа для сравнения элементов.

Параметры

source

IEnumerable<TSource>

Последовательность значений для определения максимального значения.

keySelector

Func<TSource,TKey>

Функция для извлечения ключа для каждого элемента.

Возвращаемое значение

TSource

Значение с максимальным ключом в последовательности.

Исключения

ArgumentNullException

source null.

ArgumentException

Ключ, извлеченный из source, не реализует интерфейс IComparable или IComparable<T>.

InvalidOperationException

TSource — это примитивный тип, и исходная последовательность пуста.

Комментарии

Если исходная последовательность пуста, возможны два возможных результата в зависимости от типа источника. Если TSource является типом, допускаемым значением NULL, этот метод возвращает null. Если TSource является ненулевой структурой, например примитивным типом, создается InvalidOperationException.

Если исходная последовательность содержит только значения, null, этот метод возвращает null.

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

Исходный код:

Max.cs

Возвращает максимальное значение в универсальной последовательности в соответствии с указанной функцией селектора ключей и компратором ключей.

C#

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

Параметры типа

TSource

Тип элементов source.

TKey

Тип ключа для сравнения элементов.

Параметры

source

IEnumerable<TSource>

Последовательность значений для определения максимального значения.

keySelector

Func<TSource,TKey>

Функция для извлечения ключа для каждого элемента.

comparer

IComparer<TKey>

IComparer<T> для сравнения ключей.

Возвращаемое значение

TSource

Значение с максимальным ключом в последовательности.

Исключения

ArgumentNullException

source null.

ArgumentException

Ключ, извлеченный из source, не реализует интерфейс IComparable или IComparable<T>.

InvalidOperationException

TSource — это примитивный тип, и исходная последовательность пуста.

Комментарии

Если исходная последовательность пуста, возможны два возможных результата в зависимости от типа источника. Если TSource является типом, допускаемым значением NULL, этот метод возвращает null. Если TSource является ненулевой структурой, например примитивным типом, создается InvalidOperationException.

Если исходная последовательность содержит только значения, null, этот метод возвращает null.