Queryable.Max Metoda

Definicja

Przestrzeń nazw:

System.Linq

Zestaw:

System.Linq.Queryable.dll

Przeciążenia

Max<TSource,TResult>(IQueryable<TSource>, Expression<Func<TSource,TResult>>)	Wywołuje funkcję projekcji dla każdego elementu ogólnego IQueryable<T> i zwraca maksymalną wynikową wartość.
Max<TSource>(IQueryable<TSource>)	Zwraca wartość maksymalną w ogólnym IQueryable<T>obiekcie .
Max<TSource>(IQueryable<TSource>, IComparer<TSource>)	Zwraca wartość maksymalną w ogólnym IQueryable<T>obiekcie .

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

Źródło:

Queryable.cs

Wywołuje funkcję projekcji dla każdego elementu ogólnego IQueryable<T> i zwraca maksymalną wynikową wartość.

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);

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

Parametry typu

TSource

Typ elementów elementu source.

TResult

Typ wartości zwróconej przez funkcję reprezentowaną przez selectorfunkcję .

Parametry

source

IQueryable<TSource>

Sekwencja wartości określających maksymalną wartość.

selector

Expression<Func<TSource,TResult>>

Funkcja projekcji, która ma być stosowana do każdego elementu.

Zwraca

TResult

Maksymalna wartość w sekwencji.

Wyjątki

ArgumentNullException

source lub selector to null.

InvalidOperationException

source nie zawiera żadnych elementów.

Przykłady

W poniższym przykładzie kodu pokazano, jak użyć Max<TSource,TResult>(IQueryable<TSource>, Expression<Func<TSource,TResult>>) metody określania maksymalnej wartości w sekwencji przewidywanych wartości.

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.

Uwagi

Ta metoda ma co najmniej jeden parametr typu Expression<TDelegate> , którego argument type jest jednym z Func<T,TResult> typów. W przypadku tych parametrów można przekazać wyrażenie lambda i zostanie skompilowane do elementu Expression<TDelegate>.

Metoda Max<TSource,TResult>(IQueryable<TSource>, Expression<Func<TSource,TResult>>) generuje element MethodCallExpression , który reprezentuje wywołanie Max<TSource,TResult>(IQueryable<TSource>, Expression<Func<TSource,TResult>>) siebie jako skonstruowaną metodę ogólną. Następnie przekazuje MethodCallExpression element do Execute<TResult>(Expression) metody reprezentowanej IQueryProvider przez Provider właściwość parametru source .

Zachowanie zapytania, które występuje w wyniku wykonania drzewa wyrażeń, które reprezentuje wywołanie Max<TSource,TResult>(IQueryable<TSource>, Expression<Func<TSource,TResult>>) , zależy od implementacji typu parametru source . Oczekiwane zachowanie polega na tym, że wywołuje selector on każdy element w source obiekcie i zwraca maksymalną wartość.

Max<TSource>(IQueryable<TSource>)

Źródło:

Queryable.cs

Zwraca wartość maksymalną w ogólnym IQueryable<T>obiekcie .

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);

static member Max : System.Linq.IQueryable<'Source> -> 'Source

<Extension()>
Public Function Max(Of TSource) (source As IQueryable(Of TSource)) As TSource

Parametry typu

TSource

Typ elementów elementu source.

Parametry

source

IQueryable<TSource>

Sekwencja wartości określających maksymalną wartość.

Zwraca

TSource

Maksymalna wartość w sekwencji.

Wyjątki

ArgumentNullException

source to null.

InvalidOperationException

source nie zawiera żadnych elementów.

Przykłady

W poniższym przykładzie kodu pokazano, jak użyć Max<TSource>(IQueryable<TSource>) metody określania maksymalnej wartości w sekwencji.

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.

Uwagi

Metoda Max<TSource>(IQueryable<TSource>) generuje element MethodCallExpression , który reprezentuje wywołanie Max<TSource>(IQueryable<TSource>) siebie jako skonstruowaną metodę ogólną. Następnie przekazuje MethodCallExpression element do Execute<TResult>(Expression) metody reprezentowanej IQueryProvider przez Provider właściwość parametru source .

Zachowanie zapytania, które występuje w wyniku wykonania drzewa wyrażeń, które reprezentuje wywołanie Max<TSource>(IQueryable<TSource>) , zależy od implementacji typu parametru source . Oczekiwane zachowanie polega na tym, że zwraca maksymalną wartość w elemecie source.

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

Źródło:

Queryable.cs

Zwraca wartość maksymalną w ogólnym IQueryable<T>obiekcie .

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

Parametry typu

TSource

Typ elementów elementu source.

Parametry

source

IQueryable<TSource>

Kolejność wartości do określenia wartości maksymalnej.

comparer

IComparer<TSource>

Element IComparer<T> do porównywania wartości.

Zwraca

TSource

Maksymalna wartość w sekwencji.

Wyjątki

ArgumentNullException

source to null.