Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

Enumerable.GroupBy<TSource, TKey, TElement> méthode (IEnumerable<TSource>, Func<TSource, TKey>, Func<TSource, TElement>, IEqualityComparer<TKey>)

 

Date de publication : novembre 2016

Regroupe les éléments d’une séquence selon une fonction de sélection de clé. Les clés sont comparées à l'aide d'un comparateur et les éléments de chaque groupe sont projetés à l'aide d'une fonction spécifique.

Espace de noms:   System.Linq
Assembly:  System.Core (dans System.Core.dll)

public static IEnumerable<IGrouping<TKey, TElement>> GroupBy<TSource, TKey, TElement>(
	this IEnumerable<TSource> source,
	Func<TSource, TKey> keySelector,
	Func<TSource, TElement> elementSelector,
	IEqualityComparer<TKey> comparer
)

Paramètres

source
Type: System.Collections.Generic.IEnumerable<TSource>

Une IEnumerable<T> dont regrouper les éléments.

keySelector
Type: System.Func<TSource, TKey>

Fonction permettant d'extraire la clé de chaque élément.

elementSelector
Type: System.Func<TSource, TElement>

Fonction permettant de mapper chaque élément source à un élément dans un IGrouping<TKey, TElement>.

comparer
Type: System.Collections.Generic.IEqualityComparer<TKey>

Un IEqualityComparer<T> pour comparer les clés.

Valeur de retour

Type: System.Collections.Generic.IEnumerable<IGrouping<TKey, TElement>>

Un IEnumerable<IGrouping<TKey, TElement>> en c# ou IEnumerable(Of IGrouping(Of TKey, TElement)) dans Visual Basic où chaque IGrouping<TKey, TElement> objet contient une collection d’objets de type TElement et une clé.

Paramètres de type

TSource

Le type des éléments de source.

TKey

Le type de la clé retournée par keySelector.

TElement

Type des éléments dans le IGrouping<TKey, TElement>.

Exception Condition
ArgumentNullException

source ou keySelector ou elementSelector a la valeur null.

Cette méthode est implémentée à l’aide de l’exécution différée. L’exécution valeur de retour est un objet qui stocke toutes les informations qui sont requis pour effectuer l’action. La requête représentée par cette méthode n’est pas exécutée tant que l’objet est énumérée en appelant son GetEnumerator méthode directement ou à l’aide de foreach dans Visual C# ou For Each dans Visual Basic.

Le GroupBy<TSource, TKey, TElement>(IEnumerable<TSource>, Func<TSource, TKey>, Func<TSource, TElement>, IEqualityComparer<TKey>) méthode retourne une collection de IGrouping<TKey, TElement> objets, un pour chaque clé distincte rencontrée. Un IGrouping<TKey, TElement> est un IEnumerable<T> qui a également une clé associée à ses éléments.

Le IGrouping<TKey, TElement> objets sont rapportés selon l’ordre des éléments dans source qui produit la première clé de chaque IGrouping<TKey, TElement>. Les éléments d’un regroupement sont rapportés dans l’ordre les éléments qui les produits s’affichent dans source.

Si comparer est null, le comparateur d’égalité par défaut Default est utilisé pour comparer les clés.

Si deux clés sont considérées comme égales selon comparer, la première est choisie comme clé de regroupement.

Dans la syntaxe d’expression de requête, un group by (Visual C#) ou Group By Into (Visual Basic) clause se traduit par un appel à GroupBy. Pour plus d’informations et des exemples d’utilisation, consultez la page group, clause (Référence C#) et Group By, clause (Visual Basic).

Plateforme Windows universelle
Disponible depuis 8
.NET Framework
Disponible depuis 3.5
Bibliothèque de classes portable
Pris en charge dans : plateformes .NET portables
Silverlight
Disponible depuis 2.0
Silverlight pour Windows Phone
Disponible depuis 7.0
Windows Phone
Disponible depuis 8.1
Retour au début
Afficher: