Enumerable.Aggregate Methode

Definition

Überlädt

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

Wendet eine Akkumulatorfunktion auf eine Sequenz an Der angegebene Startwert wird als erster Akkumulatorwert verwendet, und der Ergebniswert wird mit der angegebenen Funktion ausgewählt.

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

Wendet eine Akkumulatorfunktion auf eine Sequenz an Der angegebene Startwert wird als erster Akkumulatorwert verwendet.

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

Wendet eine Akkumulatorfunktion auf eine Sequenz an

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

Wendet eine Akkumulatorfunktion auf eine Sequenz an Der angegebene Startwert wird als erster Akkumulatorwert verwendet, und der Ergebniswert wird mit der angegebenen Funktion ausgewählt.

public:
generic <typename TSource, typename TAccumulate, typename TResult>
[System::Runtime::CompilerServices::Extension]
 static TResult Aggregate(System::Collections::Generic::IEnumerable<TSource> ^ source, TAccumulate seed, Func<TAccumulate, TSource, TAccumulate> ^ func, Func<TAccumulate, TResult> ^ resultSelector);
public static TResult Aggregate<TSource,TAccumulate,TResult> (this System.Collections.Generic.IEnumerable<TSource> source, TAccumulate seed, Func<TAccumulate,TSource,TAccumulate> func, Func<TAccumulate,TResult> resultSelector);
static member Aggregate : seq<'Source> * 'Accumulate * Func<'Accumulate, 'Source, 'Accumulate> * Func<'Accumulate, 'Result> -> 'Result
<Extension()>
Public Function Aggregate(Of TSource, TAccumulate, TResult) (source As IEnumerable(Of TSource), seed As TAccumulate, func As Func(Of TAccumulate, TSource, TAccumulate), resultSelector As Func(Of TAccumulate, TResult)) As TResult

Typparameter

TSource

Der Typ der Elemente von source.

TAccumulate

Der Typ des Akkumulatorwerts.

TResult

Der Typ des Ergebniswerts.

Parameter

source
IEnumerable<TSource>

Ein IEnumerable<T>, das aggregiert werden soll

seed
TAccumulate

Der erste Akkumulatorwert.

func
Func<TAccumulate,TSource,TAccumulate>

Eine Akkumulatorfunktion, die für jedes Element aufgerufen werden soll.

resultSelector
Func<TAccumulate,TResult>

Eine Funktion zum Transformieren des letzten Akkumulatorwerts in den Ergebniswert.

Gibt zurück

TResult

Der transformierte letzte Akkumulatorwert.

Ausnahmen

source oder func oder resultSelector ist null.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie eine Akkumulatorfunktion und eine Ergebnisauswahl anwenden Aggregate .

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

// Determine whether any string in the array is longer than "banana".
string longestName =
    fruits.Aggregate("banana",
                    (longest, next) =>
                        next.Length > longest.Length ? next : longest,
    // Return the final result as an upper case 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.
Sub AggregateEx3()
    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.Aggregate("banana",
                     Function(ByVal longest, ByVal fruit) _
                         IIf(fruit.Length > longest.Length, fruit, longest),
                     Function(ByVal fruit) fruit.ToUpper())

    ' Display the output.
    Console.WriteLine($"The fruit with the longest name is {longestName}")
End Sub

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

Hinweise

Die Aggregate<TSource,TAccumulate,TResult>(IEnumerable<TSource>, TAccumulate, Func<TAccumulate,TSource,TAccumulate>, Func<TAccumulate,TResult>) Methode erleichtert das Ausführen einer Berechnung über eine Abfolge von Werten. Diese Methode funktioniert durch einmaliges Aufrufen func jedes Elements in source. func Bei jedem Aufruf Aggregate<TSource,TAccumulate,TResult>(IEnumerable<TSource>, TAccumulate, Func<TAccumulate,TSource,TAccumulate>, Func<TAccumulate,TResult>) werden sowohl das Element aus der Sequenz als auch ein aggregierter Wert (als erstes Argument an func) übergeben. Der Wert des seed Parameters wird als anfänglicher Aggregatwert verwendet. Das Ergebnis ersetzt func den vorherigen aggregierten Wert. Das Endergebnis wird func übergeben, um resultSelector das Endergebnis von Aggregate<TSource,TAccumulate,TResult>(IEnumerable<TSource>, TAccumulate, Func<TAccumulate,TSource,TAccumulate>, Func<TAccumulate,TResult>).

Um allgemeine Aggregationsvorgänge zu vereinfachen, umfassen die Standardabfrageoperatoren auch eine allgemeine Zählungsmethode, Countund vier numerische Aggregationsmethoden, nämlich Min, Max, Sumund Average.

Gilt für:

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

Wendet eine Akkumulatorfunktion auf eine Sequenz an Der angegebene Startwert wird als erster Akkumulatorwert verwendet.

public:
generic <typename TSource, typename TAccumulate>
[System::Runtime::CompilerServices::Extension]
 static TAccumulate Aggregate(System::Collections::Generic::IEnumerable<TSource> ^ source, TAccumulate seed, Func<TAccumulate, TSource, TAccumulate> ^ func);
public static TAccumulate Aggregate<TSource,TAccumulate> (this System.Collections.Generic.IEnumerable<TSource> source, TAccumulate seed, Func<TAccumulate,TSource,TAccumulate> func);
static member Aggregate : seq<'Source> * 'Accumulate * Func<'Accumulate, 'Source, 'Accumulate> -> 'Accumulate
<Extension()>
Public Function Aggregate(Of TSource, TAccumulate) (source As IEnumerable(Of TSource), seed As TAccumulate, func As Func(Of TAccumulate, TSource, TAccumulate)) As TAccumulate

Typparameter

TSource

Der Typ der Elemente von source.

TAccumulate

Der Typ des Akkumulatorwerts.

Parameter

source
IEnumerable<TSource>

Ein IEnumerable<T>, das aggregiert werden soll

seed
TAccumulate

Der erste Akkumulatorwert.

func
Func<TAccumulate,TSource,TAccumulate>

Eine Akkumulatorfunktion, die für jedes Element aufgerufen werden soll.

Gibt zurück

TAccumulate

Der letzte Akkumulatorwert.

Ausnahmen

source oder func ist null.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie eine Akkumulatorfunktion anwenden Aggregate und einen Seedwert verwenden.

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.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
Sub AggregateEx2()
    ' Create an array of Integers.
    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.Aggregate(0,
                   Function(ByVal total, ByVal number) _
                       IIf(number Mod 2 = 0, total + 1, total))

    ' Display the output.
    Console.WriteLine($"The number of even integers is {numEven}")
End Sub

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

Hinweise

Die Aggregate<TSource,TAccumulate>(IEnumerable<TSource>, TAccumulate, Func<TAccumulate,TSource,TAccumulate>) Methode erleichtert das Ausführen einer Berechnung über eine Abfolge von Werten. Diese Methode funktioniert durch einmaliges Aufrufen func jedes Elements in source. func Bei jedem Aufruf Aggregate<TSource,TAccumulate>(IEnumerable<TSource>, TAccumulate, Func<TAccumulate,TSource,TAccumulate>) werden sowohl das Element aus der Sequenz als auch ein aggregierter Wert (als erstes Argument an func) übergeben. Der Wert des seed Parameters wird als anfänglicher Aggregatwert verwendet. Das Ergebnis ersetzt func den vorherigen aggregierten Wert. Aggregate<TSource,TAccumulate>(IEnumerable<TSource>, TAccumulate, Func<TAccumulate,TSource,TAccumulate>) gibt das endergebnis von func.

Um allgemeine Aggregationsvorgänge zu vereinfachen, umfassen die Standardabfrageoperatoren auch eine allgemeine Zählungsmethode, Countund vier numerische Aggregationsmethoden, nämlich Min, Max, Sumund Average.

Gilt für:

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

Wendet eine Akkumulatorfunktion auf eine Sequenz an

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static TSource Aggregate(System::Collections::Generic::IEnumerable<TSource> ^ source, Func<TSource, TSource, TSource> ^ func);
public static TSource Aggregate<TSource> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,TSource,TSource> func);
static member Aggregate : seq<'Source> * Func<'Source, 'Source, 'Source> -> 'Source
<Extension()>
Public Function Aggregate(Of TSource) (source As IEnumerable(Of TSource), func As Func(Of TSource, TSource, TSource)) As TSource

Typparameter

TSource

Der Typ der Elemente von source.

Parameter

source
IEnumerable<TSource>

Ein IEnumerable<T>, das aggregiert werden soll

func
Func<TSource,TSource,TSource>

Eine Akkumulatorfunktion, die für jedes Element aufgerufen werden soll.

Gibt zurück

TSource

Der letzte Akkumulatorwert.

Ausnahmen

source oder func ist null.

source enthält keine Elemente.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die Reihenfolge von Wörtern in einer Zeichenfolge mithilfe von .Aggregate

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

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

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

Console.WriteLine(reversed);

// This code produces the following output:
//
// dog lazy the over jumps fox brown quick the
Sub AggregateEx1()
    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)
    ' Prepend each word to the beginning of the new sentence to reverse the word order.
    Dim reversed As String =
    words.Aggregate(Function(ByVal current, ByVal word) word & " " & current)

    ' Display the output.
    Console.WriteLine(reversed)
End Sub

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

Hinweise

Die Aggregate<TSource>(IEnumerable<TSource>, Func<TSource,TSource,TSource>) Methode erleichtert das Ausführen einer Berechnung über eine Abfolge von Werten. Diese Methode funktioniert, indem sie für jedes Element mit Ausnahme des ersten Elements source einmal aufruftfunc. func Bei jedem Aufruf Aggregate<TSource>(IEnumerable<TSource>, Func<TSource,TSource,TSource>) werden sowohl das Element aus der Sequenz als auch ein aggregierter Wert (als erstes Argument an func) übergeben. Das erste Element wird source als anfänglicher Aggregatwert verwendet. Das Ergebnis ersetzt func den vorherigen aggregierten Wert. Aggregate<TSource>(IEnumerable<TSource>, Func<TSource,TSource,TSource>) gibt das endergebnis von func.

Diese Überladung der Aggregate Methode eignet sich nicht für alle Fälle, da es das erste Element des source ersten Aggregatwerts verwendet. Sie sollten eine weitere Überladung auswählen, wenn der Rückgabewert nur die Elemente source enthalten soll, die einer bestimmten Bedingung entsprechen. Diese Überladung ist beispielsweise nicht zuverlässig, wenn Sie die Summe der geraden Zahlen in sourceberechnen möchten. Das Ergebnis ist falsch, wenn das erste Element ungerade statt sogar ist.

Um allgemeine Aggregationsvorgänge zu vereinfachen, umfassen die Standardabfrageoperatoren auch eine allgemeine Zählungsmethode, Countund vier numerische Aggregationsmethoden, nämlich Min, Max, Sumund Average.

Gilt für: