Queryable.Aggregate Método

Definição

Namespace:

System.Linq

Assemblies:

netstandard.dll, System.Linq.Queryable.dll

Sobrecargas

Nome	Description
Aggregate<TSource,TAccumulate,TResult>(IQueryable<TSource>, TAccumulate, Expression<Func<TAccumulate,TSource,TAccumulate>>, Expression<Func<TAccumulate, TResult>>)	Aplica uma função de acumulador em uma sequência. O valor de semente especificado é usado como o valor inicial do acumulador e a função especificada é usada para selecionar o valor do resultado.
Aggregate<TSource,TAccumulate>(IQueryable<TSource>, TAccumulate, Expression<Func<TAccumulate,TSource,TAccumulate>>)	Aplica uma função de acumulador em uma sequência. O valor de semente especificado é usado como o valor inicial do acumulador.
Aggregate<TSource>(IQueryable<TSource>, Expression<Func<TSource,TSource,TSource>>)	Aplica uma função de acumulador em uma sequência.

Aggregate<TSource,TAccumulate,TResult>(IQueryable<TSource>, TAccumulate, Expression<Func<TAccumulate,TSource,TAccumulate>>, Expression<Func<TAccumulate, TResult>>)

Origem:

Queryable.cs

Aplica uma função de acumulador em uma sequência. O valor de semente especificado é usado como o valor inicial do acumulador e a função especificada é usada para selecionar o valor do resultado.

public:
generic <typename TSource, typename TAccumulate, typename TResult>
[System::Runtime::CompilerServices::Extension]
 static TResult Aggregate(System::Linq::IQueryable<TSource> ^ source, TAccumulate seed, System::Linq::Expressions::Expression<Func<TAccumulate, TSource, TAccumulate> ^> ^ func, System::Linq::Expressions::Expression<Func<TAccumulate, TResult> ^> ^ selector);

public static TResult Aggregate<TSource,TAccumulate,TResult>(this System.Linq.IQueryable<TSource> source, TAccumulate seed, System.Linq.Expressions.Expression<Func<TAccumulate,TSource,TAccumulate>> func, System.Linq.Expressions.Expression<Func<TAccumulate,TResult>> selector);

static member Aggregate : System.Linq.IQueryable<'Source> * 'Accumulate * System.Linq.Expressions.Expression<Func<'Accumulate, 'Source, 'Accumulate>> * System.Linq.Expressions.Expression<Func<'Accumulate, 'Result>> -> 'Result

<Extension()>
Public Function Aggregate(Of TSource, TAccumulate, TResult) (source As IQueryable(Of TSource), seed As TAccumulate, func As Expression(Of Func(Of TAccumulate, TSource, TAccumulate)), selector As Expression(Of Func(Of TAccumulate, TResult))) As TResult

Parâmetros de tipo

TSource

O tipo dos elementos de source.

TAccumulate

O tipo do valor acumulador.

TResult

O tipo do valor resultante.

Parâmetros

source

IQueryable<TSource>

Uma sequência para agregar.

seed

TAccumulate

O valor inicial do acumulador.

func

Expression<Func<TAccumulate,TSource,TAccumulate>>

Uma função de acumulador a ser invocada em cada elemento.

selector

Expression<Func<TAccumulate,TResult>>

Uma função para transformar o valor do acumulador final no valor do resultado.

Retornos

TResult

O valor do acumulador final transformado.

Exceções

ArgumentNullException

source ou ou funcselector é null.

Exemplos

O exemplo de código a seguir demonstra como usar Aggregate<TSource,TAccumulate,TResult>(IQueryable<TSource>, TAccumulate, Expression<Func<TAccumulate,TSource,TAccumulate>>, Expression<Func<TAccumulate, TResult>>) para aplicar uma função de acumulador e um seletor de resultados.

string[] fruits = { "apple", "mango", "orange", "passionfruit", "grape" };

// Determine whether any string in the array is longer than "banana".
string longestName =
    fruits.AsQueryable().Aggregate(
    "banana",
    (longest, next) => next.Length > longest.Length ? next : longest,
    // Return the final result as an uppercase string.
    fruit => fruit.ToUpper()
    );

Console.WriteLine(
    "The fruit with the longest name is {0}.",
    longestName);

// This code produces the following output:
//
// The fruit with the longest name is PASSIONFRUIT.

Dim fruits() As String = {"apple", "mango", "orange", "passionfruit", "grape"}

' Determine whether any string in the array is longer than "banana".
Dim longestName As String = _
    fruits.AsQueryable().Aggregate( _
    "banana", _
    Function(ByVal longest, ByVal fruit) IIf(fruit.Length > longest.Length, fruit, longest), _
    Function(ByVal fruit) fruit.ToUpper() _
)

MsgBox(String.Format( _
    "The fruit with the longest name is {0}.", longestName) _
)

' This code produces the following output:
'
' The fruit with the longest name is PASSIONFRUIT.

Comentários

Esse método tem pelo menos um parâmetro de tipo Expression<TDelegate> cujo argumento de tipo é um dos Func<T,TResult> tipos. Para esses parâmetros, você pode passar uma expressão lambda e ela será compilada para um Expression<TDelegate>.

O Aggregate<TSource,TAccumulate,TResult>(IQueryable<TSource>, TAccumulate, Expression<Func<TAccumulate,TSource,TAccumulate>>, Expression<Func<TAccumulate, TResult>>) método gera um MethodCallExpression que representa chamar Aggregate<TSource,TAccumulate,TResult>(IQueryable<TSource>, TAccumulate, Expression<Func<TAccumulate,TSource,TAccumulate>>, Expression<Func<TAccumulate, TResult>>) a si mesmo como um método genérico construído. Em seguida, ele passa o MethodCallExpressionExecute<TResult>(Expression) método do IQueryProvider representado pela Provider propriedade do source parâmetro.

O comportamento da consulta que ocorre como resultado da execução de uma árvore de expressão que representa a chamada Aggregate<TSource,TAccumulate,TResult>(IQueryable<TSource>, TAccumulate, Expression<Func<TAccumulate,TSource,TAccumulate>>, Expression<Func<TAccumulate, TResult>>) depende da implementação do tipo do source parâmetro. O comportamento esperado é que a função funcespecificada seja aplicada a cada valor na sequência de origem e o valor acumulado seja retornado. O seed parâmetro é usado como o valor de semente para o valor acumulado, que corresponde ao primeiro parâmetro em func. O valor acumulado final é passado para selector obter o valor do resultado.

Para simplificar as operações de agregação comuns, o conjunto de operadores de consulta padrão também inclui dois métodos Count de contagem e LongCount, e quatro métodos de agregação numérica, ou seja Max, Min, Sume Average.

Aggregate<TSource,TAccumulate>(IQueryable<TSource>, TAccumulate, Expression<Func<TAccumulate,TSource,TAccumulate>>)

Origem:

Queryable.cs

Aplica uma função de acumulador em uma sequência. O valor de semente especificado é usado como o valor inicial do acumulador.

public:
generic <typename TSource, typename TAccumulate>
[System::Runtime::CompilerServices::Extension]
 static TAccumulate Aggregate(System::Linq::IQueryable<TSource> ^ source, TAccumulate seed, System::Linq::Expressions::Expression<Func<TAccumulate, TSource, TAccumulate> ^> ^ func);

public static TAccumulate Aggregate<TSource,TAccumulate>(this System.Linq.IQueryable<TSource> source, TAccumulate seed, System.Linq.Expressions.Expression<Func<TAccumulate,TSource,TAccumulate>> func);

static member Aggregate : System.Linq.IQueryable<'Source> * 'Accumulate * System.Linq.Expressions.Expression<Func<'Accumulate, 'Source, 'Accumulate>> -> 'Accumulate

<Extension()>
Public Function Aggregate(Of TSource, TAccumulate) (source As IQueryable(Of TSource), seed As TAccumulate, func As Expression(Of Func(Of TAccumulate, TSource, TAccumulate))) As TAccumulate

Parâmetros de tipo

TSource

O tipo dos elementos de source.

TAccumulate

O tipo do valor acumulador.

Parâmetros

source

IQueryable<TSource>

Uma sequência para agregar.

seed

TAccumulate

O valor inicial do acumulador.

func

Expression<Func<TAccumulate,TSource,TAccumulate>>

Uma função de acumulador a ser invocada em cada elemento.

Retornos

TAccumulate

O valor final do acumulador.

Exceções

ArgumentNullException

source ou func é null.

Exemplos

O exemplo de código a seguir demonstra como usar Aggregate<TSource,TAccumulate>(IQueryable<TSource>, TAccumulate, Expression<Func<TAccumulate,TSource,TAccumulate>>) para aplicar uma função de acumulador quando um valor de semente é fornecido à função.

int[] ints = { 4, 8, 8, 3, 9, 0, 7, 8, 2 };

// Count the even numbers in the array, using a seed value of 0.
int numEven =
    ints.AsQueryable().Aggregate(
    0,
    (total, next) => next % 2 == 0 ? total + 1 : total
    );

Console.WriteLine("The number of even integers is: {0}", numEven);

// This code produces the following output:
//
// The number of even integers is: 6

Dim ints() As Integer = {4, 8, 8, 3, 9, 0, 7, 8, 2}

' Count the even numbers in the array, using a seed value of 0.
Dim numEven As Integer = _
    ints.AsQueryable().Aggregate( _
        0, _
        Function(ByVal total, ByVal number) _
            IIf(number Mod 2 = 0, total + 1, total) _
    )

MsgBox(String.Format("The number of even integers is: {0}", numEven))

' This code produces the following output:
'
' The number of even integers is: 6

Comentários

Esse método tem pelo menos um parâmetro de tipo Expression<TDelegate> cujo argumento de tipo é um dos Func<T,TResult> tipos. Para esses parâmetros, você pode passar uma expressão lambda e ela será compilada para um Expression<TDelegate>.

O Aggregate<TSource,TAccumulate>(IQueryable<TSource>, TAccumulate, Expression<Func<TAccumulate,TSource,TAccumulate>>) método gera um MethodCallExpression que representa chamar Aggregate<TSource,TAccumulate>(IQueryable<TSource>, TAccumulate, Expression<Func<TAccumulate,TSource,TAccumulate>>) a si mesmo como um método genérico construído. Em seguida, ele passa o MethodCallExpressionExecute<TResult>(Expression) método do IQueryProvider representado pela Provider propriedade do source parâmetro.

O comportamento da consulta que ocorre como resultado da execução de uma árvore de expressão que representa a chamada Aggregate<TSource,TAccumulate>(IQueryable<TSource>, TAccumulate, Expression<Func<TAccumulate,TSource,TAccumulate>>) depende da implementação do tipo do source parâmetro. O comportamento esperado é que a função funcespecificada seja aplicada a cada valor na sequência de origem e o valor acumulado seja retornado. O seed parâmetro é usado como o valor de semente para o valor acumulado, que corresponde ao primeiro parâmetro em func.

Para simplificar as operações de agregação comuns, o conjunto de operadores de consulta padrão também inclui dois métodos Count de contagem e LongCount, e quatro métodos de agregação numérica, ou seja Max, Min, Sume Average.

Aggregate<TSource>(IQueryable<TSource>, Expression<Func<TSource,TSource,TSource>>)

Origem:

Queryable.cs

Aplica uma função de acumulador em uma sequência.

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static TSource Aggregate(System::Linq::IQueryable<TSource> ^ source, System::Linq::Expressions::Expression<Func<TSource, TSource, TSource> ^> ^ func);

public static TSource Aggregate<TSource>(this System.Linq.IQueryable<TSource> source, System.Linq.Expressions.Expression<Func<TSource,TSource,TSource>> func);

static member Aggregate : System.Linq.IQueryable<'Source> * System.Linq.Expressions.Expression<Func<'Source, 'Source, 'Source>> -> 'Source

<Extension()>
Public Function Aggregate(Of TSource) (source As IQueryable(Of TSource), func As Expression(Of Func(Of TSource, TSource, TSource))) As TSource

Parâmetros de tipo

TSource

O tipo dos elementos de source.

Parâmetros

source

IQueryable<TSource>

Uma sequência para agregar.

func

Expression<Func<TSource,TSource,TSource>>

Uma função de acumulador a ser aplicada a cada elemento.

Retornos

TSource

O valor final do acumulador.

Exceções

ArgumentNullException

source ou func é null.

InvalidOperationException

source não contém elementos.

Exemplos

O exemplo de código a seguir demonstra como usar Aggregate<TSource>(IQueryable<TSource>, Expression<Func<TSource,TSource,TSource>>) para criar uma frase de uma matriz de cadeias de caracteres.

string sentence = "the quick brown fox jumps over the lazy dog";

// Split the string into individual words.
string[] words = sentence.Split(' ');

// Use Aggregate() to prepend each word to the beginning of the
// new sentence to reverse the word order.
string reversed =
    words.AsQueryable().Aggregate(
    (workingSentence, next) => next + " " + workingSentence
    );

Console.WriteLine(reversed);

// This code produces the following output:
//
// dog lazy the over jumps fox brown quick the

Dim sentence As String = "the quick brown fox jumps over the lazy dog"

' Split the string into individual words.
Dim words() As String = sentence.Split(" "c)

' Use Aggregate() to prepend each word to the beginning of the 
' new sentence to reverse the word order.
Dim reversed As String = _
    words.AsQueryable().Aggregate( _
        Function(ByVal workingSentence, ByVal nextWord) nextWord & " " & workingSentence _
    )

MsgBox(reversed)

' This code produces the following output:
'
' dog lazy the over jumps fox brown quick the

Comentários

Esse método tem pelo menos um parâmetro de tipo Expression<TDelegate> cujo argumento de tipo é um dos Func<T,TResult> tipos. Para esses parâmetros, você pode passar uma expressão lambda e ela será compilada para um Expression<TDelegate>.

O Aggregate<TSource>(IQueryable<TSource>, Expression<Func<TSource,TSource,TSource>>) método gera um MethodCallExpression que representa chamar Aggregate<TSource>(IQueryable<TSource>, Expression<Func<TSource,TSource,TSource>>) a si mesmo como um método genérico construído. Em seguida, ele passa o MethodCallExpressionExecute<TResult>(Expression) método do IQueryProvider representado pela Provider propriedade do source parâmetro.

O comportamento da consulta que ocorre como resultado da execução de uma árvore de expressão que representa a chamada Aggregate<TSource>(IQueryable<TSource>, Expression<Func<TSource,TSource,TSource>>) depende da implementação do tipo do source parâmetro. O comportamento esperado é que a função funcespecificada seja aplicada a cada valor na sequência de origem e o valor acumulado seja retornado. O primeiro valor é source usado como o valor de semente para o valor acumulado, que corresponde ao primeiro parâmetro em func.

Para simplificar as operações de agregação comuns, o conjunto de operadores de consulta padrão também inclui dois métodos Count de contagem e LongCount, e quatro métodos de agregação numérica, ou seja Max, Min, Sume Average.