Queryable.Aggregate Método

Definição

Espaço de Nomes:: System.Linq

Assemblagens:: System.Core.dll, System.Linq.Queryable.dll

Assemblagem:: System.Core.dll

Assemblagem:: netstandard.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Sobrecargas

Name	Description
Aggregate<TSource,TAccumulate,TResult>(IQueryable<TSource>, TAccumulate, Expression<Func<TAccumulate,TSource,TAccumulate>>, Expression<Func<TAccumulate, TResult>>)	Aplica uma função acumuladora sobre uma sequência. O valor semente especificado é usado como 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 acumuladora sobre uma sequência. O valor semente especificado é usado como valor inicial do acumulador.
Aggregate<TSource>(IQueryable<TSource>, Expression<Func<TSource,TSource,TSource>>)	Aplica uma função acumuladora sobre uma sequência.

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

Aplica uma função acumuladora sobre uma sequência. O valor semente especificado é usado como 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 Genérico

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 acumuladora para invocar em cada elemento.

selector: Expression<Func<TAccumulate,TResult>>

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

Devoluções

TResult

O valor final do acumulador transformado.

Exceções

ArgumentNullException

source ou func ou selector é null.

Exemplos

O seguinte exemplo de código demonstra como aplicar Aggregate<TSource,TAccumulate,TResult>(IQueryable<TSource>, TAccumulate, Expression<Func<TAccumulate,TSource,TAccumulate>>, Expression<Func<TAccumulate, TResult>>) uma função acumuladora 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.

Observações

Este método tem pelo menos um parâmetro de tipo Expression<TDelegate> cujo argumento de tipo é um dos Func<T,TResult> tipos. Para estes parâmetros, pode-se 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 o autodenominado Aggregate<TSource,TAccumulate,TResult>(IQueryable<TSource>, TAccumulate, Expression<Func<TAccumulate,TSource,TAccumulate>>, Expression<Func<TAccumulate, TResult>>) como um método genérico construído. Depois passa o MethodCallExpression para o Execute<TResult>(Expression) método de o IQueryProvider representado pela Provider propriedade do source parâmetro.

O comportamento de consulta que ocorre como resultado da execução de uma árvore de expressões 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 especificada, func, seja aplicada a cada valor na sequência de origem e o valor acumulado seja devolvido. O seed parâmetro é usado como valor semente para o valor acumulado, que corresponde ao primeiro parâmetro em func. O valor final acumulado é passado para selector obter o valor do resultado.

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

Aplica-se a

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

Aplica uma função acumuladora sobre uma sequência. O valor semente especificado é usado como 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 Genérico

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 acumuladora para invocar em cada elemento.

Devoluções

TAccumulate

O valor final do acumulador.

Exceções

ArgumentNullException

source ou func é null.

Exemplos

O exemplo de código seguinte demonstra como aplicar Aggregate<TSource,TAccumulate>(IQueryable<TSource>, TAccumulate, Expression<Func<TAccumulate,TSource,TAccumulate>>) uma função acumuladora quando é fornecido um valor semente à 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

Observações

O Aggregate<TSource,TAccumulate>(IQueryable<TSource>, TAccumulate, Expression<Func<TAccumulate,TSource,TAccumulate>>) método gera um MethodCallExpression que representa o autodenominado Aggregate<TSource,TAccumulate>(IQueryable<TSource>, TAccumulate, Expression<Func<TAccumulate,TSource,TAccumulate>>) como um método genérico construído. Depois passa o MethodCallExpression para o Execute<TResult>(Expression) método de o IQueryProvider representado pela Provider propriedade do source parâmetro.

O comportamento de consulta que ocorre como resultado da execução de uma árvore de expressões 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 especificada, func, seja aplicada a cada valor na sequência de origem e o valor acumulado seja devolvido. O seed parâmetro é usado como valor semente para o valor acumulado, que corresponde ao primeiro parâmetro em func.

Aplica-se a

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

Aplica uma função acumuladora sobre 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 Genérico

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 acumuladora para aplicar a cada elemento.

Devoluções

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 seguinte demonstra como usar Aggregate<TSource>(IQueryable<TSource>, Expression<Func<TSource,TSource,TSource>>) para construir uma frase a partir de um array 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

Observações

O Aggregate<TSource>(IQueryable<TSource>, Expression<Func<TSource,TSource,TSource>>) método gera um MethodCallExpression que representa o autodenominado Aggregate<TSource>(IQueryable<TSource>, Expression<Func<TSource,TSource,TSource>>) como um método genérico construído. Depois passa o MethodCallExpression para o Execute<TResult>(Expression) método de o IQueryProvider representado pela Provider propriedade do source parâmetro.

O comportamento de consulta que ocorre como resultado da execução de uma árvore de expressões 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 especificada, func, seja aplicada a cada valor na sequência de origem e o valor acumulado seja devolvido. O primeiro valor em source é usado como valor semente para o valor acumulado, que corresponde ao primeiro parâmetro em func.

Aplica-se a

Comentários

Esta página foi útil?