Queryable.Aggregate Méthode

Définition

Espace de noms:

System.Linq

Assemblys:

netstandard.dll, System.Linq.Queryable.dll

Surcharges

Nom	Description
Aggregate<TSource,TAccumulate,TResult>(IQueryable<TSource>, TAccumulate, Expression<Func<TAccumulate,TSource,TAccumulate>>, Expression<Func<TAccumulate, TResult>>)	Applique une fonction d’accumulation sur une séquence. La valeur initiale spécifiée est utilisée comme valeur d’accumulation initiale et la fonction spécifiée est utilisée pour sélectionner la valeur de résultat.
Aggregate<TSource,TAccumulate>(IQueryable<TSource>, TAccumulate, Expression<Func<TAccumulate,TSource,TAccumulate>>)	Applique une fonction d’accumulation sur une séquence. La valeur initiale spécifiée est utilisée comme valeur d’accumulation initiale.
Aggregate<TSource>(IQueryable<TSource>, Expression<Func<TSource,TSource,TSource>>)	Applique une fonction d’accumulation sur une séquence.

Aggregate<TSource,TAccumulate,TResult>(IQueryable<TSource>, TAccumulate, Expression<Func<TAccumulate,TSource,TAccumulate>>, Expression<Func<TAccumulate, TResult>>)

Source:

Queryable.cs

Applique une fonction d’accumulation sur une séquence. La valeur initiale spécifiée est utilisée comme valeur d’accumulation initiale et la fonction spécifiée est utilisée pour sélectionner la valeur de résultat.

public:
generic <typename TSource, typename TAccumulate, typename TResult>
[System::Runtime::CompilerServices::Extension]
 static TResult Aggregate(System::Linq::IQueryable<TSource> ^ source, TAccumulate seed, System::Linq::Expressions::Expression<Func<TAccumulate, TSource, TAccumulate> ^> ^ func, System::Linq::Expressions::Expression<Func<TAccumulate, TResult> ^> ^ selector);

public static TResult Aggregate<TSource,TAccumulate,TResult>(this System.Linq.IQueryable<TSource> source, TAccumulate seed, System.Linq.Expressions.Expression<Func<TAccumulate,TSource,TAccumulate>> func, System.Linq.Expressions.Expression<Func<TAccumulate,TResult>> selector);

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

<Extension()>
Public Function Aggregate(Of TSource, TAccumulate, TResult) (source As IQueryable(Of TSource), seed As TAccumulate, func As Expression(Of Func(Of TAccumulate, TSource, TAccumulate)), selector As Expression(Of Func(Of TAccumulate, TResult))) As TResult

Paramètres de type

TSource

Type des éléments de source.

TAccumulate

Type de la valeur d’accumulation.

TResult

Type de la valeur résultante.

Paramètres

source

IQueryable<TSource>

Séquence à agréger.

seed

TAccumulate

Valeur d’accumulation initiale.

func

Expression<Func<TAccumulate,TSource,TAccumulate>>

Fonction d’accumulation à appeler sur chaque élément.

selector

Expression<Func<TAccumulate,TResult>>

Fonction permettant de transformer la valeur d’accumulation finale en valeur de résultat.

Retours

TResult

Valeur d’accumulation finale transformée.

Exceptions

ArgumentNullException

source selector ou func est null.

Exemples

L’exemple de code suivant montre comment utiliser Aggregate<TSource,TAccumulate,TResult>(IQueryable<TSource>, TAccumulate, Expression<Func<TAccumulate,TSource,TAccumulate>>, Expression<Func<TAccumulate, TResult>>) pour appliquer une fonction d’accumulation et un sélecteur de résultats.

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

// Determine whether any string in the array is longer than "banana".
string longestName =
    fruits.AsQueryable().Aggregate(
    "banana",
    (longest, next) => next.Length > longest.Length ? next : longest,
    // Return the final result as an uppercase 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.

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.AsQueryable().Aggregate( _
    "banana", _
    Function(ByVal longest, ByVal fruit) IIf(fruit.Length > longest.Length, fruit, longest), _
    Function(ByVal fruit) fruit.ToUpper() _
)

MsgBox(String.Format( _
    "The fruit with the longest name is {0}.", longestName) _
)

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

Remarques

Cette méthode a au moins un paramètre de type Expression<TDelegate> dont l’argument de type est l’un des Func<T,TResult> types. Pour ces paramètres, vous pouvez passer une expression lambda et elle sera compilée à un Expression<TDelegate>.

La Aggregate<TSource,TAccumulate,TResult>(IQueryable<TSource>, TAccumulate, Expression<Func<TAccumulate,TSource,TAccumulate>>, Expression<Func<TAccumulate, TResult>>) méthode génère un qui représente l’appel MethodCallExpressionAggregate<TSource,TAccumulate,TResult>(IQueryable<TSource>, TAccumulate, Expression<Func<TAccumulate,TSource,TAccumulate>>, Expression<Func<TAccumulate, TResult>>) lui-même en tant que méthode générique construite. Il passe ensuite la MethodCallExpressionExecute<TResult>(Expression) méthode de l’objet IQueryProvider représenté par la Provider propriété du source paramètre.

Le comportement de requête qui se produit suite à l’exécution d’une arborescence d’expressions qui représente l’appel Aggregate<TSource,TAccumulate,TResult>(IQueryable<TSource>, TAccumulate, Expression<Func<TAccumulate,TSource,TAccumulate>>, Expression<Func<TAccumulate, TResult>>) dépend de l’implémentation du type du source paramètre. Le comportement attendu est que la fonction spécifiée, est funcappliquée à chaque valeur de la séquence source et que la valeur cumulée est retournée. Le seed paramètre est utilisé comme valeur initiale pour la valeur cumulée, qui correspond au premier paramètre dans func. La valeur cumulée finale est passée pour selector obtenir la valeur de résultat.

Pour simplifier les opérations d’agrégation courantes, l’ensemble d’opérateurs de requête standard inclut également deux méthodes de comptage et CountLongCount, et quatre méthodes d’agrégation numérique, à savoir Max, MinSumet Average.

Aggregate<TSource,TAccumulate>(IQueryable<TSource>, TAccumulate, Expression<Func<TAccumulate,TSource,TAccumulate>>)

Source:

Queryable.cs

Applique une fonction d’accumulation sur une séquence. La valeur initiale spécifiée est utilisée comme valeur d’accumulation initiale.

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

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

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

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

Paramètres de type

TSource

Type des éléments de source.

TAccumulate

Type de la valeur d’accumulation.

Paramètres

source

IQueryable<TSource>

Séquence à agréger.

seed

TAccumulate

Valeur d’accumulation initiale.

func

Expression<Func<TAccumulate,TSource,TAccumulate>>

Fonction d’accumulation à appeler sur chaque élément.

Retours

TAccumulate

Valeur d’accumulation finale.

Exceptions

ArgumentNullException

source ou func est null.

Exemples

L’exemple de code suivant montre comment utiliser Aggregate<TSource,TAccumulate>(IQueryable<TSource>, TAccumulate, Expression<Func<TAccumulate,TSource,TAccumulate>>) pour appliquer une fonction d’accumulation lorsqu’une valeur initiale est fournie à la fonction.

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.AsQueryable().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

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.AsQueryable().Aggregate( _
        0, _
        Function(ByVal total, ByVal number) _
            IIf(number Mod 2 = 0, total + 1, total) _
    )

MsgBox(String.Format("The number of even integers is: {0}", numEven))

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

Remarques

Cette méthode a au moins un paramètre de type Expression<TDelegate> dont l’argument de type est l’un des Func<T,TResult> types. Pour ces paramètres, vous pouvez passer une expression lambda et elle sera compilée à un Expression<TDelegate>.

La Aggregate<TSource,TAccumulate>(IQueryable<TSource>, TAccumulate, Expression<Func<TAccumulate,TSource,TAccumulate>>) méthode génère un qui représente l’appel MethodCallExpressionAggregate<TSource,TAccumulate>(IQueryable<TSource>, TAccumulate, Expression<Func<TAccumulate,TSource,TAccumulate>>) lui-même en tant que méthode générique construite. Il passe ensuite la MethodCallExpressionExecute<TResult>(Expression) méthode de l’objet IQueryProvider représenté par la Provider propriété du source paramètre.

Le comportement de requête qui se produit suite à l’exécution d’une arborescence d’expressions qui représente l’appel Aggregate<TSource,TAccumulate>(IQueryable<TSource>, TAccumulate, Expression<Func<TAccumulate,TSource,TAccumulate>>) dépend de l’implémentation du type du source paramètre. Le comportement attendu est que la fonction spécifiée, est funcappliquée à chaque valeur de la séquence source et que la valeur cumulée est retournée. Le seed paramètre est utilisé comme valeur initiale pour la valeur cumulée, qui correspond au premier paramètre dans func.

Pour simplifier les opérations d’agrégation courantes, l’ensemble d’opérateurs de requête standard inclut également deux méthodes de comptage et CountLongCount, et quatre méthodes d’agrégation numérique, à savoir Max, MinSumet Average.

Aggregate<TSource>(IQueryable<TSource>, Expression<Func<TSource,TSource,TSource>>)

Source:

Queryable.cs

Applique une fonction d’accumulation sur une séquence.

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

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

static member Aggregate : System.Linq.IQueryable<'Source> * System.Linq.Expressions.Expression<Func<'Source, 'Source, 'Source>> -> 'Source

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

Paramètres de type

TSource

Type des éléments de source.

Paramètres

source

IQueryable<TSource>

Séquence à agréger.

func

Expression<Func<TSource,TSource,TSource>>

Fonction d’accumulation à appliquer à chaque élément.

Retours

TSource

Valeur d’accumulation finale.

Exceptions

ArgumentNullException

source ou func est null.

InvalidOperationException

source ne contient aucun élément.

Exemples

L’exemple de code suivant montre comment utiliser Aggregate<TSource>(IQueryable<TSource>, Expression<Func<TSource,TSource,TSource>>) pour générer une phrase à partir d’un tableau de chaînes.

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

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

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

Console.WriteLine(reversed);

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

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)

' Use Aggregate() to prepend each word to the beginning of the 
' new sentence to reverse the word order.
Dim reversed As String = _
    words.AsQueryable().Aggregate( _
        Function(ByVal workingSentence, ByVal nextWord) nextWord & " " & workingSentence _
    )

MsgBox(reversed)

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

Remarques

Cette méthode a au moins un paramètre de type Expression<TDelegate> dont l’argument de type est l’un des Func<T,TResult> types. Pour ces paramètres, vous pouvez passer une expression lambda et elle sera compilée à un Expression<TDelegate>.

La Aggregate<TSource>(IQueryable<TSource>, Expression<Func<TSource,TSource,TSource>>) méthode génère un qui représente l’appel MethodCallExpressionAggregate<TSource>(IQueryable<TSource>, Expression<Func<TSource,TSource,TSource>>) lui-même en tant que méthode générique construite. Il passe ensuite la MethodCallExpressionExecute<TResult>(Expression) méthode de l’objet IQueryProvider représenté par la Provider propriété du source paramètre.

Le comportement de requête qui se produit suite à l’exécution d’une arborescence d’expressions qui représente l’appel Aggregate<TSource>(IQueryable<TSource>, Expression<Func<TSource,TSource,TSource>>) dépend de l’implémentation du type du source paramètre. Le comportement attendu est que la fonction spécifiée, est funcappliquée à chaque valeur de la séquence source et que la valeur cumulée est retournée. La première valeur dans source est utilisée comme valeur initiale pour la valeur cumulée, qui correspond au premier paramètre dans func.

Pour simplifier les opérations d’agrégation courantes, l’ensemble d’opérateurs de requête standard inclut également deux méthodes de comptage et CountLongCount, et quatre méthodes d’agrégation numérique, à savoir Max, MinSumet Average.