WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C#

Enumerable.GroupBy — Gruppieren nach einem Schlüssel

Enumerable.GroupBy teilt eine Sequenz anhand eines ausgewählten Schlüssels in Gruppen auf. Jede Gruppe stellt ihren Schlüssel über Key bereit; ihre Elemente lassen sich direkt als Sequenz durchlaufen.

Version: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Syntax

IEnumerable<IGrouping<TKey, TSource>> groups = source.GroupBy(keySelector);
IEnumerable<IGrouping<TKey, TElement>> groups = source.GroupBy(keySelector, elementSelector);

Enumerable.GroupBy aus System.Linq gruppiert anhand von keySelector. Ohne elementSelector bleiben die Quellelemente erhalten; mit elementSelector werden ihre projizierten Werte gespeichert.

Diese Überladungen geben IEnumerable<IGrouping<TKey,TElement>> zurück. IGrouping<TKey,TElement> implementiert IEnumerable<TElement>: Die Gruppe selbst ist die Sequenz ihrer Elemente und kein Objekt mit einer separaten Values-Sammlung. Die Eigenschaft IGrouping<TKey,TElement>.Key gibt den gemeinsamen Schlüssel zurück. Ohne Projektion ist TElement der Typ des Quellelements.

Die Ausführung wird bis zur Enumeration aufgeschoben. Die Gruppen folgen der Reihenfolge, in der ihre Schlüssel erstmals auftreten, und die Elemente behalten die Reihenfolge der Quelle bei; die Schlüssel werden nicht sortiert. Standardmäßig wird EqualityComparer<TKey>.Default verwendet; für einen anderen Vergleich kann IEqualityComparer<TKey> angegeben werden.

Das .NET-10-Beispiel gruppiert Wörter nach ihrer Länge. group.Key ist die Länge, und elements verweist auf die Gruppe selbst.

Beispiele

using System;
using System.Collections.Generic;
using System.Linq;

string[] words = { "pear", "fig", "plum", "kiwi", "tea" };
IEnumerable<IGrouping<int, string>> groups = words.GroupBy(word => word.Length);

foreach (IGrouping<int, string> group in groups)
{
    IEnumerable<string> elements = group;
    Console.WriteLine($"{group.Key}: {string.Join(", ", elements)}");
}

Ergebnis

4: pear, plum, kiwi
3: fig, tea

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen