Enumerable.Aggregate Methode

Referenz

Definition

Namespace:: System.Linq

Assembly:: System.Linq.dll

Assembly:: System.Core.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

Quelle:: Aggregate.cs

Quelle:: Aggregate.cs

Quelle:: Aggregate.cs

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

ArgumentNullException

source oder func oder resultSelector ist null.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie sie verwenden Aggregate , um eine Akkumulatorfunktion und eine Ergebnisauswahl anzuwenden.

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 Sequenz von Werten. Diese Methode funktioniert, indem für jedes Element in sourceeinmal aufgerufen func wird. Jedes Mal, wenn func aufgerufen wird, Aggregate<TSource,TAccumulate,TResult>(IEnumerable<TSource>, TAccumulate, Func<TAccumulate,TSource,TAccumulate>, Func<TAccumulate,TResult>) übergibt sowohl das Element aus der Sequenz als auch einen aggregierten Wert (als erstes Argument an func). Der Wert des seed Parameters wird als anfänglicher Aggregatwert verwendet. Das Ergebnis von func ersetzt den vorherigen aggregierten Wert. Das Endergebnis von func wird an übergeben, resultSelector um das Endergebnis von Aggregate<TSource,TAccumulate,TResult>(IEnumerable<TSource>, TAccumulate, Func<TAccumulate,TSource,TAccumulate>, Func<TAccumulate,TResult>)zu erhalten.

Um allgemeine Aggregationsvorgänge zu vereinfachen, enthalten die Standardabfrageoperatoren auch eine allgemeine Count-Methode, Countund vier numerische Aggregationsmethoden, nämlich Min, Sum Maxund Average.

Gilt für:

.NET 9 und andere Versionen

Produkt	Versionen
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP	10.0

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

Quelle:: Aggregate.cs

Quelle:: Aggregate.cs

Quelle:: Aggregate.cs

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

ArgumentNullException

source oder func ist null.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie sie verwenden Aggregate , um eine Akkumulatorfunktion anzuwenden und einen Startwert zu 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 Sequenz von Werten. Diese Methode funktioniert, indem für jedes Element in sourceeinmal aufgerufen func wird. Jedes Mal, wenn func aufgerufen wird, Aggregate<TSource,TAccumulate>(IEnumerable<TSource>, TAccumulate, Func<TAccumulate,TSource,TAccumulate>) übergibt sowohl das Element aus der Sequenz als auch einen aggregierten Wert (als erstes Argument an func). Der Wert des seed Parameters wird als anfänglicher Aggregatwert verwendet. Das Ergebnis von func ersetzt den vorherigen aggregierten Wert. Aggregate<TSource,TAccumulate>(IEnumerable<TSource>, TAccumulate, Func<TAccumulate,TSource,TAccumulate>) gibt das endgültige Ergebnis von zurück func.

Gilt für:

.NET 9 und andere Versionen

Produkt	Versionen
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP	10.0

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

Quelle:: Aggregate.cs

Quelle:: Aggregate.cs

Quelle:: Aggregate.cs

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

ArgumentNullException

source oder func ist null.

InvalidOperationException

source enthält keine Elemente.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die Reihenfolge der Wörter in einer Zeichenfolge mithilfe Aggregatevon umgekehrt wird.

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 Sequenz von Werten. Diese Methode funktioniert, indem für jedes Element in source mit Ausnahme des ersten einmal aufgerufen func wird. Jedes Mal, wenn func aufgerufen wird, Aggregate<TSource>(IEnumerable<TSource>, Func<TSource,TSource,TSource>) übergibt sowohl das Element aus der Sequenz als auch einen aggregierten Wert (als erstes Argument an func). Das erste Element von source wird als anfänglicher Aggregatwert verwendet. Das Ergebnis von func ersetzt den vorherigen aggregierten Wert. Aggregate<TSource>(IEnumerable<TSource>, Func<TSource,TSource,TSource>) gibt das endgültige Ergebnis von zurück func.

Diese Überladung der Aggregate -Methode ist nicht für alle Fälle geeignet, da das erste Element von source als anfänglicher Aggregatwert verwendet wird. Sie sollten eine andere Überladung auswählen, wenn der Rückgabewert nur die Elemente von source enthalten soll, die eine bestimmte Bedingung erfüllen. 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 gerade ist.

Gilt für:

.NET 9 und andere Versionen

Produkt	Versionen
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP	10.0

Freigeben über

Enumerable.Aggregate Methode

Definition

Überlädt

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

Typparameter

Parameter

Gibt zurück

Ausnahmen

Beispiele

Hinweise

Gilt für:

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

Typparameter

Parameter

Gibt zurück

Ausnahmen

Beispiele

Hinweise

Gilt für:

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

Typparameter

Parameter

Gibt zurück

Ausnahmen

Beispiele

Hinweise

Gilt für:

Zusätzliche Ressourcen