Enumerable.Aggregate Yöntem

Tanım

Ad Alanı:

System.Linq

Bütünleştirilmiş Kod:

System.Linq.dll

Aşırı Yüklemeler

Aggregate<TSource,TAccumulate,TResult>(IEnumerable<TSource>, TAccumulate, Func<TAccumulate,TSource,TAccumulate>, Func<TAccumulate,TResult>)	Bir dizi üzerinde bir biriktirici işlevi uygular. Belirtilen çekirdek değeri ilk biriktirici değeri olarak kullanılır ve belirtilen işlev sonuç değerini seçmek için kullanılır.
Aggregate<TSource,TAccumulate>(IEnumerable<TSource>, TAccumulate, Func<TAccumulate,TSource,TAccumulate>)	Bir dizi üzerinde bir biriktirici işlevi uygular. Belirtilen çekirdek değeri ilk biriktirici değeri olarak kullanılır.
Aggregate<TSource>(IEnumerable<TSource>, Func<TSource,TSource,TSource>)	Bir dizi üzerinde bir biriktirici işlevi uygular.

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

Kaynak:

Aggregate.cs

Bir dizi üzerinde bir biriktirici işlevi uygular. Belirtilen çekirdek değeri ilk biriktirici değeri olarak kullanılır ve belirtilen işlev sonuç değerini seçmek için kullanılır.

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

Tür Parametreleri

TSource

öğelerinin sourcetürü.

TAccumulate

Biriktirici değerinin türü.

TResult

Sonuçta elde edilen değerin türü.

Parametreler

source

IEnumerable<TSource>

Toplama için bir IEnumerable<T> .

seed

TAccumulate

İlk biriktirici değeri.

func

Func<TAccumulate,TSource,TAccumulate>

Her öğede çağrılacak bir biriktirici işlevi.

resultSelector

Func<TAccumulate,TResult>

Son biriktirici değerini sonuç değerine dönüştüren bir işlev.

Döndürülenler

TResult

Dönüştürülen son biriktirici değeri.

Özel durumlar

ArgumentNullException

source veya func veya resultSelector şeklindedir null.

Örnekler

Aşağıdaki kod örneği, bir biriktirici işlevi ve sonuç seçici uygulamak için nasıl kullanılacağını Aggregate gösterir.

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

Açıklamalar

yöntemi, Aggregate<TSource,TAccumulate,TResult>(IEnumerable<TSource>, TAccumulate, Func<TAccumulate,TSource,TAccumulate>, Func<TAccumulate,TResult>) bir değer dizisi üzerinde hesaplama gerçekleştirmeyi basitleştirir. Bu yöntem, içindeki her öğe için bir kez çağrılarak funcsourceçalışır. Her çağrılır func , Aggregate<TSource,TAccumulate,TResult>(IEnumerable<TSource>, TAccumulate, Func<TAccumulate,TSource,TAccumulate>, Func<TAccumulate,TResult>) hem dizideki öğeyi hem de bir toplanmış değeri (ilk bağımsız değişken funcolarak) iletir. parametresinin seed değeri ilk toplama değeri olarak kullanılır. sonucu func , önceki toplanan değerin yerini alır. öğesinin func nihai sonucu elde etmek için resultSelector son sonucu Aggregate<TSource,TAccumulate,TResult>(IEnumerable<TSource>, TAccumulate, Func<TAccumulate,TSource,TAccumulate>, Func<TAccumulate,TResult>)öğesine geçirilir.

Yaygın toplama işlemlerini basitleştirmek için, standart sorgu işleçleri genel amaçlı bir sayı yöntemi Countve , , ve Averagegibi MinMaxSumdört sayısal toplama yöntemi de içerir.

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

Kaynak:

Aggregate.cs

Bir dizi üzerinde bir biriktirici işlevi uygular. Belirtilen çekirdek değeri ilk biriktirici değeri olarak kullanılır.

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

Tür Parametreleri

TSource

öğelerinin sourcetürü.

TAccumulate

Biriktirici değerinin türü.

Parametreler

source

IEnumerable<TSource>

Toplama için bir IEnumerable<T> .

seed

TAccumulate

İlk biriktirici değeri.

func

Func<TAccumulate,TSource,TAccumulate>

Her öğede çağrılacak bir biriktirici işlevi.

Döndürülenler

TAccumulate

Son biriktirici değeri.

Özel durumlar

ArgumentNullException

source veya func şeklindedir null.

Örnekler

Aşağıdaki kod örneğinde, bir akümülatör işlevi uygulamak ve bir çekirdek değeri kullanmak için nasıl Aggregate kullanılacağı gösterilmektedir.

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

Açıklamalar

yöntemi, Aggregate<TSource,TAccumulate>(IEnumerable<TSource>, TAccumulate, Func<TAccumulate,TSource,TAccumulate>) bir değer dizisi üzerinde hesaplama gerçekleştirmeyi basitleştirir. Bu yöntem, içindeki her öğe için bir kez çağrılarak funcsourceçalışır. Her çağrılır func , Aggregate<TSource,TAccumulate>(IEnumerable<TSource>, TAccumulate, Func<TAccumulate,TSource,TAccumulate>) hem dizideki öğeyi hem de bir toplanmış değeri (ilk bağımsız değişken funcolarak) iletir. parametresinin seed değeri ilk toplama değeri olarak kullanılır. sonucu func , önceki toplanan değerin yerini alır. Aggregate<TSource,TAccumulate>(IEnumerable<TSource>, TAccumulate, Func<TAccumulate,TSource,TAccumulate>) öğesinin nihai sonucunu funcdöndürür.

Yaygın toplama işlemlerini basitleştirmek için, standart sorgu işleçleri genel amaçlı bir sayı yöntemi Countve , , ve Averagegibi MinMaxSumdört sayısal toplama yöntemi de içerir.

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

Kaynak:

Aggregate.cs

Bir dizi üzerinde bir biriktirici işlevi uygular.

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

Tür Parametreleri

TSource

öğelerinin sourcetürü.

Parametreler

source

IEnumerable<TSource>

Toplama için bir IEnumerable<T> .

func

Func<TSource,TSource,TSource>

Her öğede çağrılacak bir biriktirici işlevi.

Döndürülenler

TSource

Son biriktirici değeri.

Özel durumlar

ArgumentNullException

source veya func şeklindedir null.

InvalidOperationException

source öğe içermiyor.

Örnekler

Aşağıdaki kod örneğinde kullanarak Aggregatebir dizedeki sözcüklerin sırasının nasıl tersine çevrildiği gösterilmektedir.

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

Açıklamalar

yöntemi, Aggregate<TSource>(IEnumerable<TSource>, Func<TSource,TSource,TSource>) bir değer dizisi üzerinde hesaplama gerçekleştirmeyi basitleştirir. Bu yöntem, içindeki ilk öğe dışında her öğe source için bir kez çağrılarak func çalışır. Her çağrılır func , Aggregate<TSource>(IEnumerable<TSource>, Func<TSource,TSource,TSource>) hem dizideki öğeyi hem de bir toplanmış değeri (ilk bağımsız değişken funcolarak) iletir. öğesinin source ilk öğesi ilk toplama değeri olarak kullanılır. sonucu func , önceki toplanan değerin yerini alır. Aggregate<TSource>(IEnumerable<TSource>, Func<TSource,TSource,TSource>) öğesinin nihai sonucunu funcdöndürür.

yönteminin Aggregate bu aşırı yüklemesi, ilk toplama değeri olarak öğesinin ilk öğesini source kullandığından tüm durumlar için uygun değildir. Dönüş değerinin yalnızca belirli bir koşulu karşılayan öğelerini source içermesi gerekiyorsa başka bir aşırı yükleme seçmelisiniz. Örneğin, içindeki çift sayıların sourcetoplamını hesaplamak istiyorsanız bu aşırı yükleme güvenilir değildir. İlk öğe çift yerine tekse sonuç yanlış olur.

Yaygın toplama işlemlerini basitleştirmek için, standart sorgu işleçleri genel amaçlı bir sayı yöntemi Countve , , ve Averagegibi MinMaxSumdört sayısal toplama yöntemi de içerir.