Queryable.Max Метод

  • Ссылка

Определение

Пространство имен:
System.Linq
Сборка:
System.Linq.Queryable.dll
Сборка:
System.Core.dll
Сборка:
netstandard.dll

Перегрузки

Max<TSource,TResult>(IQueryable<TSource>, Expression<Func<TSource,TResult>>)

Вызывает функцию проекции для каждого элемента универсального интерфейса IQueryable<T> и возвращает максимальное результирующее значение.
Max<TSource>(IQueryable<TSource>)

Возвращает максимальное значение для универсального интерфейса IQueryable<T>.
Max<TSource>(IQueryable<TSource>, IComparer<TSource>)

Возвращает максимальное значение для универсального интерфейса IQueryable<T>.

Max<TSource,TResult>(IQueryable<TSource>, Expression<Func<TSource,TResult>>)

Вызывает функцию проекции для каждого элемента универсального интерфейса IQueryable<T> и возвращает максимальное результирующее значение.

public:
generic <typename TSource, typename TResult>
[System::Runtime::CompilerServices::Extension]
 static TResult Max(System::Linq::IQueryable<TSource> ^ source, System::Linq::Expressions::Expression<Func<TSource, TResult> ^> ^ selector);
public static TResult Max<TSource,TResult> (this System.Linq.IQueryable<TSource> source, System.Linq.Expressions.Expression<Func<TSource,TResult>> selector);
public static TResult? Max<TSource,TResult> (this System.Linq.IQueryable<TSource> source, System.Linq.Expressions.Expression<Func<TSource,TResult>> selector);
static member Max : System.Linq.IQueryable<'Source> * System.Linq.Expressions.Expression<Func<'Source, 'Result>> -> 'Result
<Extension()>
Public Function Max(Of TSource, TResult) (source As IQueryable(Of TSource), selector As Expression(Of Func(Of TSource, TResult))) As TResult

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

TSource

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

TResult

Тип значения, возвращаемого функцией, заданной параметром selector.

Параметры

source
IQueryable<TSource>

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

selector
Expression<Func<TSource,TResult>>

Функция проекции, применяемая к каждому элементу.

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

TResult

Максимальное значение в последовательности.

Исключения

ArgumentNullException

Параметр source или selector имеет значение null.

InvalidOperationException

Последовательность source не содержит элементов.

Примеры

В следующем примере кода показано, как использовать для Max<TSource,TResult>(IQueryable<TSource>, Expression<Func<TSource,TResult>>) определения максимального значения в последовательности проецируемых значений.

class Pet
{
    public string Name { get; set; }
    public int Age { get; set; }
}

public static void MaxEx2()
{
    Pet[] pets = { new Pet { Name="Barley", Age=8 },
                   new Pet { Name="Boots", Age=4 },
                   new Pet { Name="Whiskers", Age=1 } };

    // Add Pet.Age to the length of Pet.Name
    // to determine the "maximum" Pet object in the array.
    int max =
        pets.AsQueryable().Max(pet => pet.Age + pet.Name.Length);

    Console.WriteLine(
        "The maximum pet age plus name length is {0}.",
        max);
}

/*
    This code produces the following output:

    The maximum pet age plus name length is 14.
*/

Structure Pet
    Public Name As String
    Public Age As Integer
End Structure

Shared Sub MaxEx2()
    Dim pets() As Pet = {New Pet With {.Name = "Barley", .Age = 8}, _
                   New Pet With {.Name = "Boots", .Age = 4}, _
                   New Pet With {.Name = "Whiskers", .Age = 1}}

    ' Add Pet.Age to the length of Pet.Name
    ' to determine the "maximum" Pet object in the array.
    Dim max As Integer = _
        pets.AsQueryable().Max(Function(pet) pet.Age + pet.Name.Length)

    MsgBox(String.Format("The maximum pet age plus name length is {0}.", max))

    'This code produces the following output:

    'The maximum pet age plus name length is 14.

Комментарии

Этот метод имеет по крайней мере один параметр типа Expression<TDelegate> , аргумент типа которого является одним из Func<T,TResult> типов. Для этих параметров можно передать лямбда-выражение, и оно будет скомпилировано в .Expression<TDelegate>

Метод Max<TSource,TResult>(IQueryable<TSource>, Expression<Func<TSource,TResult>>) создает объект MethodCallExpression , представляющий себя как Max<TSource,TResult>(IQueryable<TSource>, Expression<Func<TSource,TResult>>) созданный универсальный метод. Затем он передает MethodCallExpression Execute<TResult>(Expression) метод, представленный IQueryProvider свойством Provider source параметра.

Поведение запроса, возникающее в результате выполнения дерева выражений, представляющего вызов Max<TSource,TResult>(IQueryable<TSource>, Expression<Func<TSource,TResult>>) , зависит от реализации типа source параметра. Ожидаемое поведение заключается в том, что он вызывает selector каждый элемент и source возвращает максимальное значение.

Применяется к

Max<TSource>(IQueryable<TSource>)

Возвращает максимальное значение для универсального интерфейса IQueryable<T>.

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static TSource Max(System::Linq::IQueryable<TSource> ^ source);
public static TSource Max<TSource> (this System.Linq.IQueryable<TSource> source);
public static TSource? Max<TSource> (this System.Linq.IQueryable<TSource> source);
static member Max : System.Linq.IQueryable<'Source> -> 'Source
<Extension()>
Public Function Max(Of TSource) (source As IQueryable(Of TSource)) As TSource

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

TSource

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

Параметры

source
IQueryable<TSource>

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

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

TSource

Максимальное значение в последовательности.

Исключения

ArgumentNullException

source имеет значение null.

InvalidOperationException

Последовательность source не содержит элементов.

Примеры

В следующем примере кода показано, как определить Max<TSource>(IQueryable<TSource>) максимальное значение последовательности.

List<long> longs = new List<long> { 4294967296L, 466855135L, 81125L };

long max = longs.AsQueryable().Max();

Console.WriteLine("The largest number is {0}.", max);

/*
    This code produces the following output:

    The largest number is 4294967296.
*/

Dim longs As New List(Of Long)(New Long() {4294967296L, 466855135L, 81125L})

Dim max As Long = longs.AsQueryable().Max()

MsgBox(String.Format("The largest number is {0}.", max))

'This code produces the following output:

'The largest number is 4294967296.

Комментарии

Метод Max<TSource>(IQueryable<TSource>) создает объект MethodCallExpression , представляющий себя как Max<TSource>(IQueryable<TSource>) созданный универсальный метод. Затем он передает MethodCallExpression Execute<TResult>(Expression) метод, представленный IQueryProvider свойством Provider source параметра.

Поведение запроса, возникающее в результате выполнения дерева выражений, представляющего вызов Max<TSource>(IQueryable<TSource>) , зависит от реализации типа source параметра. Ожидаемое поведение заключается в том, что он возвращает максимальное значение в source.

Применяется к

Max<TSource>(IQueryable<TSource>, IComparer<TSource>)

Возвращает максимальное значение для универсального интерфейса IQueryable<T>.

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static TSource Max(System::Linq::IQueryable<TSource> ^ source, System::Collections::Generic::IComparer<TSource> ^ comparer);
public static TSource? Max<TSource> (this System.Linq.IQueryable<TSource> source, System.Collections.Generic.IComparer<TSource>? comparer);
static member Max : System.Linq.IQueryable<'Source> * System.Collections.Generic.IComparer<'Source> -> 'Source
<Extension()>
Public Function Max(Of TSource) (source As IQueryable(Of TSource), comparer As IComparer(Of TSource)) As TSource

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

TSource

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

Параметры

source
IQueryable<TSource>

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

comparer
IComparer<TSource>

Компаратор IComparer<T>, используемый для сравнения значений.

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

TSource

Максимальное значение в последовательности.

Исключения

ArgumentNullException

source имеет значение null.

Применяется к