ParallelEnumerable.Aggregate Método

Definição

Namespace:

System.Linq

Assembly:

System.Linq.Parallel.dll

Assembly:

System.Core.dll

Assembly:

netstandard.dll

Aplica em paralelo uma função acumuladora em uma sequência.

Sobrecargas

Aggregate<TSource,TAccumulate,TResult>(ParallelQuery<TSource>, TAccumulate, Func<TAccumulate,TSource,TAccumulate>, Func<TAccumulate,TResult>)	Aplica em paralelo uma função acumuladora 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,TResult>(ParallelQuery<TSource>, Func<TAccumulate>, Func<TAccumulate,TSource,TAccumulate>, Func<TAccumulate, TAccumulate,TAccumulate>, Func<TAccumulate,TResult>)	Aplica em paralelo uma função acumuladora em uma sequência. Essa sobrecarga não está disponível na implementação sequencial.
Aggregate<TSource,TAccumulate,TResult>(ParallelQuery<TSource>, TAccumulate, Func<TAccumulate,TSource,TAccumulate>, Func<TAccumulate, TAccumulate,TAccumulate>, Func<TAccumulate,TResult>)	Aplica em paralelo uma função acumuladora em uma sequência. Essa sobrecarga não está disponível na implementação sequencial.
Aggregate<TSource,TAccumulate>(ParallelQuery<TSource>, TAccumulate, Func<TAccumulate,TSource,TAccumulate>)	Aplica em paralelo uma função acumuladora em uma sequência. O valor de semente especificado é usado como o valor inicial do acumulador.
Aggregate<TSource>(ParallelQuery<TSource>, Func<TSource,TSource,TSource>)	Aplica em paralelo uma função acumuladora em uma sequência.

Aggregate<TSource,TAccumulate,TResult>(ParallelQuery<TSource>, TAccumulate, Func<TAccumulate,TSource,TAccumulate>, Func<TAccumulate,TResult>)

Aplica em paralelo uma função acumuladora 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::ParallelQuery<TSource> ^ source, TAccumulate seed, Func<TAccumulate, TSource, TAccumulate> ^ func, Func<TAccumulate, TResult> ^ resultSelector);

public static TResult Aggregate<TSource,TAccumulate,TResult> (this System.Linq.ParallelQuery<TSource> source, TAccumulate seed, Func<TAccumulate,TSource,TAccumulate> func, Func<TAccumulate,TResult> resultSelector);

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

<Extension()>
Public Function Aggregate(Of TSource, TAccumulate, TResult) (source As ParallelQuery(Of TSource), seed As TAccumulate, func As Func(Of TAccumulate, TSource, TAccumulate), resultSelector As Func(Of TAccumulate, TResult)) As TResult

Parâmetros de tipo

TSource

O tipo dos elementos de source.

TAccumulate

O tipo do valor do acumulador.

TResult

O tipo do valor resultante.

Parâmetros

source

ParallelQuery<TSource>

Uma sequência a ser agregada.

seed

TAccumulate

O valor inicial do acumulador.

func

Func<TAccumulate,TSource,TAccumulate>

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

resultSelector

Func<TAccumulate,TResult>

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

Retornos

TResult

O valor final do acumulador transformado.

Exceções

OperationCanceledException

A consulta foi cancelada com o token transmitido pelo WithCancellation<TSource>(ParallelQuery<TSource>, CancellationToken).

ArgumentNullException

source ou func ou resultSelector é uma referência nula (Nothing no Visual Basic).

AggregateException

Uma ou mais exceções ocorreram durante a avaliação da consulta.

InvalidOperationException

source não contém elementos.

Confira também

• LINQ paralelo (PLINQ)

Aggregate<TSource,TAccumulate,TResult>(ParallelQuery<TSource>, Func<TAccumulate>, Func<TAccumulate,TSource,TAccumulate>, Func<TAccumulate, TAccumulate,TAccumulate>, Func<TAccumulate,TResult>)

Aplica em paralelo uma função acumuladora em uma sequência. Essa sobrecarga não está disponível na implementação sequencial.

public:
generic <typename TSource, typename TAccumulate, typename TResult>
[System::Runtime::CompilerServices::Extension]
 static TResult Aggregate(System::Linq::ParallelQuery<TSource> ^ source, Func<TAccumulate> ^ seedFactory, Func<TAccumulate, TSource, TAccumulate> ^ updateAccumulatorFunc, Func<TAccumulate, TAccumulate, TAccumulate> ^ combineAccumulatorsFunc, Func<TAccumulate, TResult> ^ resultSelector);

public static TResult Aggregate<TSource,TAccumulate,TResult> (this System.Linq.ParallelQuery<TSource> source, Func<TAccumulate> seedFactory, Func<TAccumulate,TSource,TAccumulate> updateAccumulatorFunc, Func<TAccumulate,TAccumulate,TAccumulate> combineAccumulatorsFunc, Func<TAccumulate,TResult> resultSelector);

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

<Extension()>
Public Function Aggregate(Of TSource, TAccumulate, TResult) (source As ParallelQuery(Of TSource), seedFactory As Func(Of TAccumulate), updateAccumulatorFunc As Func(Of TAccumulate, TSource, TAccumulate), combineAccumulatorsFunc As Func(Of TAccumulate, TAccumulate, TAccumulate), resultSelector As Func(Of TAccumulate, TResult)) As TResult

Parâmetros de tipo

TSource

O tipo dos elementos de source.

TAccumulate

O tipo do valor do acumulador.

TResult

O tipo do valor resultante.

Parâmetros

source

ParallelQuery<TSource>

Uma sequência a ser agregada.

seedFactory

Func<TAccumulate>

Uma função que retorna o valor inicial do acumulador.

updateAccumulatorFunc

Func<TAccumulate,TSource,TAccumulate>

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

combineAccumulatorsFunc

Func<TAccumulate,TAccumulate,TAccumulate>

Uma função de acumulador a ser invocada produziu resultado do acumulador de cada partição.

resultSelector

Func<TAccumulate,TResult>

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

Retornos

TResult

O valor final do acumulador transformado.

Exceções

OperationCanceledException

A consulta foi cancelada com o token transmitido pelo WithCancellation<TSource>(ParallelQuery<TSource>, CancellationToken).

ArgumentNullException

source ou seedFactory ou updateAccumulatorFunc ou combineAccumulatorsFunc ou resultSelector é uma referência nula (Nothing no Visual Basic).

AggregateException

Uma ou mais exceções ocorreram durante a avaliação da consulta.

InvalidOperationException

source não contém elementos.

Comentários

Essa sobrecarga é específica para consultas paralelizadas. Uma consulta paralelizada pode particionar a sequência da fonte de dados em várias sub-sequências (partições). O updateAccumulatorFunc é invocado em cada elemento dentro de partições. Cada partição produz um único resultado acumulado. Em combineAccumulatorsFunc seguida, é invocado nos resultados de cada partição para produzir um único elemento. Esse elemento é transformado pela resultSelector função.

Confira também

• LINQ paralelo (PLINQ)

Aggregate<TSource,TAccumulate,TResult>(ParallelQuery<TSource>, TAccumulate, Func<TAccumulate,TSource,TAccumulate>, Func<TAccumulate, TAccumulate,TAccumulate>, Func<TAccumulate,TResult>)

Aplica em paralelo uma função acumuladora em uma sequência. Essa sobrecarga não está disponível na implementação sequencial.

public:
generic <typename TSource, typename TAccumulate, typename TResult>
[System::Runtime::CompilerServices::Extension]
 static TResult Aggregate(System::Linq::ParallelQuery<TSource> ^ source, TAccumulate seed, Func<TAccumulate, TSource, TAccumulate> ^ updateAccumulatorFunc, Func<TAccumulate, TAccumulate, TAccumulate> ^ combineAccumulatorsFunc, Func<TAccumulate, TResult> ^ resultSelector);

public static TResult Aggregate<TSource,TAccumulate,TResult> (this System.Linq.ParallelQuery<TSource> source, TAccumulate seed, Func<TAccumulate,TSource,TAccumulate> updateAccumulatorFunc, Func<TAccumulate,TAccumulate,TAccumulate> combineAccumulatorsFunc, Func<TAccumulate,TResult> resultSelector);

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

<Extension()>
Public Function Aggregate(Of TSource, TAccumulate, TResult) (source As ParallelQuery(Of TSource), seed As TAccumulate, updateAccumulatorFunc As Func(Of TAccumulate, TSource, TAccumulate), combineAccumulatorsFunc As Func(Of TAccumulate, TAccumulate, TAccumulate), resultSelector As Func(Of TAccumulate, TResult)) As TResult

Parâmetros de tipo

TSource

O tipo dos elementos de source.

TAccumulate

O tipo do valor do acumulador.

TResult

O tipo do valor resultante.

Parâmetros

source

ParallelQuery<TSource>

Uma sequência a ser agregada.

seed

TAccumulate

O valor inicial do acumulador.

updateAccumulatorFunc

Func<TAccumulate,TSource,TAccumulate>

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

combineAccumulatorsFunc

Func<TAccumulate,TAccumulate,TAccumulate>

Uma função de acumulador a ser invocada produziu resultado do acumulador de cada partição.

resultSelector

Func<TAccumulate,TResult>

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

Retornos

TResult

O valor final do acumulador transformado.

Exceções

OperationCanceledException

A consulta foi cancelada com o token transmitido pelo WithCancellation<TSource>(ParallelQuery<TSource>, CancellationToken).

ArgumentNullException

source ou updateAccumulatorFunc ou combineAccumulatorsFunc ou resultSelector é uma referência nula (Nothing no Visual Basic).

AggregateException

Uma ou mais exceções ocorreram durante a avaliação da consulta.

InvalidOperationException

source não contém elementos.

Comentários

Essa sobrecarga é específica para processar uma consulta paralelizada. Uma consulta paralelizada pode particionar a sequência da fonte de dados em várias sub-sequências (partições). O updateAccumulatorFunc é invocado em cada elemento dentro de partições. Cada partição produz um único resultado acumulado. Em combineAccumulatorsFunc seguida, é invocado nos resultados de cada partição para produzir um único elemento. Esse elemento é transformado pela resultSelector função.

Confira também

• LINQ paralelo (PLINQ)

Aggregate<TSource,TAccumulate>(ParallelQuery<TSource>, TAccumulate, Func<TAccumulate,TSource,TAccumulate>)

Aplica em paralelo uma função acumuladora 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::ParallelQuery<TSource> ^ source, TAccumulate seed, Func<TAccumulate, TSource, TAccumulate> ^ func);

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

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

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

Parâmetros de tipo

TSource

O tipo dos elementos de source.

TAccumulate

O tipo do valor do acumulador.

Parâmetros

source

ParallelQuery<TSource>

Uma sequência a ser agregada.

seed

TAccumulate

O valor inicial do acumulador.

func

Func<TAccumulate,TSource,TAccumulate>

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

Retornos

TAccumulate

O valor final do acumulador.

Exceções

OperationCanceledException

A consulta foi cancelada com o token transmitido pelo WithCancellation<TSource>(ParallelQuery<TSource>, CancellationToken).

ArgumentNullException

source ou func é uma referência nula (Nothing no Visual Basic).

AggregateException

Uma ou mais exceções ocorreram durante a avaliação da consulta.

InvalidOperationException

source não contém elementos.

Confira também

• LINQ paralelo (PLINQ)

Aggregate<TSource>(ParallelQuery<TSource>, Func<TSource,TSource,TSource>)

Aplica em paralelo uma função acumuladora em uma sequência.

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

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

static member Aggregate : System.Linq.ParallelQuery<'Source> * Func<'Source, 'Source, 'Source> -> 'Source

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

Parâmetros de tipo

TSource

O tipo dos elementos de source.

Parâmetros

source

ParallelQuery<TSource>

Uma sequência a ser agregada.

func

Func<TSource,TSource,TSource>

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

Retornos

TSource

O valor final do acumulador.

Exceções

OperationCanceledException

A consulta foi cancelada com o token transmitido pelo WithCancellation<TSource>(ParallelQuery<TSource>, CancellationToken).

ArgumentNullException

source ou func é uma referência nula (Nothing no Visual Basic).

AggregateException

Uma ou mais exceções ocorreram durante a avaliação da consulta.

InvalidOperationException

source não contém elementos.

Confira também

• LINQ paralelo (PLINQ)