Enumerable.Aggregate Метод

Определение

Пространство имен:: System.Linq

Сборки:: System.Core.dll, System.Linq.dll

Сборка:: System.Core.dll

Сборка:: System.Linq.dll

Сборка:: netstandard.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Перегрузки

Имя	Описание
Aggregate<TSource,TAccumulate,TResult>(IEnumerable<TSource>, TAccumulate, Func<TAccumulate,TSource,TAccumulate>, Func<TAccumulate,TResult>)	Применяет функцию аккумулятора по последовательности. Указанное начальное значение используется в качестве начального значения аккумулятора, а указанная функция используется для выбора значения результата.
Aggregate<TSource,TAccumulate>(IEnumerable<TSource>, TAccumulate, Func<TAccumulate,TSource,TAccumulate>)	Применяет функцию аккумулятора по последовательности. Указанное начальное значение используется в качестве начального значения аккумулятора.
Aggregate<TSource>(IEnumerable<TSource>, Func<TSource,TSource,TSource>)	Применяет функцию аккумулятора по последовательности.

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

Применяет функцию аккумулятора по последовательности. Указанное начальное значение используется в качестве начального значения аккумулятора, а указанная функция используется для выбора значения результата.

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

Параметры типа

TSource

Тип элементов source.

TAccumulate

Тип значения аккумулятора.

TResult

Тип результирующего значения.

Параметры

source: IEnumerable<TSource>

Значение IEnumerable<T> для агрегирования.

seed: TAccumulate

Начальное значение аккумулятора.

func: Func<TAccumulate,TSource,TAccumulate>

Вызываемая функция-аккумулятор для каждого элемента.

resultSelector: Func<TAccumulate,TResult>

Функция для преобразования окончательного значения аккумулятора в значение результата.

Возвращаемое значение

TResult

Преобразованное окончательное значение аккумулятора.

Исключения

ArgumentNullException

source или funcresultSelector есть null.

Примеры

В следующем примере кода показано, как применить 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

Метод Aggregate<TSource,TAccumulate,TResult>(IEnumerable<TSource>, TAccumulate, Func<TAccumulate,TSource,TAccumulate>, Func<TAccumulate,TResult>) упрощает вычисление по последовательности значений. Этот метод работает путем вызова func одного раза для каждого элемента в source. Каждый раз func вызывается, Aggregate<TSource,TAccumulate,TResult>(IEnumerable<TSource>, TAccumulate, Func<TAccumulate,TSource,TAccumulate>, Func<TAccumulate,TResult>) передает элемент из последовательности и агрегированного значения (в качестве первого аргумента func). Значение seed параметра используется в качестве начального агрегатного значения. Результат func замены предыдущего агрегированного значения. Окончательный результат func передается для resultSelector получения окончательного Aggregate<TSource,TAccumulate,TResult>(IEnumerable<TSource>, TAccumulate, Func<TAccumulate,TSource,TAccumulate>, Func<TAccumulate,TResult>)результата.

Чтобы упростить распространенные операции агрегирования, стандартные операторы запросов также включают метод подсчета общего назначения, Countа также четыре числовых метода агрегирования, а именно Min Max, Sumи Average.

Применяется к

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

Применяет функцию аккумулятора по последовательности. Указанное начальное значение используется в качестве начального значения аккумулятора.

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

Параметры типа

TSource

Тип элементов source.

TAccumulate

Тип значения аккумулятора.

Параметры

source: IEnumerable<TSource>

Значение IEnumerable<T> для агрегирования.

seed: TAccumulate

Начальное значение аккумулятора.

func: Func<TAccumulate,TSource,TAccumulate>

Вызываемая функция-аккумулятор для каждого элемента.

Возвращаемое значение

TAccumulate

Окончательное значение аккумулятора.

Исключения

ArgumentNullException

source или func есть null.

Примеры

В следующем примере кода показано, как использовать Aggregate функцию аккумулятора и использовать начальное значение.

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

Метод Aggregate<TSource,TAccumulate>(IEnumerable<TSource>, TAccumulate, Func<TAccumulate,TSource,TAccumulate>) упрощает вычисление по последовательности значений. Этот метод работает путем вызова func одного раза для каждого элемента в source. Каждый раз func вызывается, Aggregate<TSource,TAccumulate>(IEnumerable<TSource>, TAccumulate, Func<TAccumulate,TSource,TAccumulate>) передает элемент из последовательности и агрегированного значения (в качестве первого аргумента func). Значение seed параметра используется в качестве начального агрегатного значения. Результат func замены предыдущего агрегированного значения. Aggregate<TSource,TAccumulate>(IEnumerable<TSource>, TAccumulate, Func<TAccumulate,TSource,TAccumulate>) возвращает окончательный результат func.

Применяется к

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

Применяет функцию аккумулятора по последовательности.

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

Параметры типа

TSource

Тип элементов source.

Параметры

source: IEnumerable<TSource>

Значение IEnumerable<T> для агрегирования.

func: Func<TSource,TSource,TSource>

Вызываемая функция-аккумулятор для каждого элемента.

Возвращаемое значение

TSource

Окончательное значение аккумулятора.

Исключения

ArgumentNullException

source или func есть null.

InvalidOperationException

source не содержит элементов.

Примеры

В следующем примере кода показано, как изменить порядок слов в строке с помощью 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

Метод Aggregate<TSource>(IEnumerable<TSource>, Func<TSource,TSource,TSource>) упрощает вычисление по последовательности значений. Этот метод работает путем вызова func одного раза для каждого элемента, source кроме первого. Каждый раз func вызывается, Aggregate<TSource>(IEnumerable<TSource>, Func<TSource,TSource,TSource>) передает элемент из последовательности и агрегированного значения (в качестве первого аргумента func). Первый элемент source используется в качестве начального агрегатного значения. Результат func замены предыдущего агрегированного значения. Aggregate<TSource>(IEnumerable<TSource>, Func<TSource,TSource,TSource>) возвращает окончательный результат func.

Эта перегрузка Aggregate метода не подходит для всех случаев, так как она использует первый элемент source в качестве начального агрегатного значения. Следует выбрать другую перегрузку, если возвращаемое значение должно содержать только элементы source , которые соответствуют определенному условию. Например, эта перегрузка не является надежной, если вы хотите вычислить сумму четных чисел в source. Результат будет неверным, если первый элемент нечетен, а не даже.

Применяется к

Обратная связь

Были ли сведения на этой странице полезными?

Enumerable.Aggregate Метод

Определение

Перегрузки

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

Параметры типа

Параметры

Возвращаемое значение

Исключения

Примеры

Комментарии

Применяется к

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

Параметры типа

Параметры

Возвращаемое значение

Исключения

Примеры

Комментарии

Применяется к

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

Параметры типа

Параметры

Возвращаемое значение

Исключения

Примеры

Комментарии

Применяется к