Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

Enumerable.GroupBy<TSource, TKey>-Methode: (IEnumerable<TSource>, Func<TSource, TKey>, IEqualityComparer<TKey>)

 

Veröffentlicht: Oktober 2016

Gruppiert die Elemente einer Sequenz entsprechend einer angegebenen Schlüsselauswahlfunktion und vergleicht die Schlüssel mithilfe eines angegebenen Vergleichs.

Namespace:   System.Linq
Assembly:  System.Core (in System.Core.dll)

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

Parameter

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

Ein IEnumerable<T> deren Elemente gruppiert.

keySelector
Type: System.Func<TSource, TKey>

Eine Funktion zum Extrahieren des Schlüssels für jedes Element.

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

Ein IEqualityComparer<T> zum Vergleichen von Schlüsseln.

Rückgabewert

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

Ein IEnumerable<IGrouping<TKey, TSource>> in c# oder IEnumerable(Of IGrouping(Of TKey, TSource)) in Visual Basic in dem jedes IGrouping<TKey, TElement> Objekt enthält eine Auflistung von Objekten und einen Schlüssel.

Typparameter

TSource

Der Typ der Elemente von source.

TKey

Der Typ des von keySelector zurückgegebenen Schlüssels.

Exception Condition
ArgumentNullException

source oder keySelector ist null.

Diese Methode wird mit verzögerter Ausführung implementiert. Der sofortige Rückgabewert ist ein Objekt, das alle Informationen gespeichert hat, die zum Ausführen der Aktion erforderlich sind. Die von dieser Methode dargestellte Abfrage wird nicht ausgeführt, bis das Objekt aufgelistet wird, entweder durch Aufrufen der GetEnumerator -Methode direkt oder mithilfe von foreach in Visual C# oder For Each in Visual Basic.

Die GroupBy<TSource, TKey>(IEnumerable<TSource>, Func<TSource, TKey>, IEqualityComparer<TKey>) -Methode gibt eine Auflistung von IGrouping<TKey, TElement> Objekten, eines für jeden ermittelten eindeutigen Schlüssel, der aufgetreten ist. Ein IGrouping<TKey, TElement> ist eine IEnumerable<T> die auch einen Schlüssel, dessen Elemente zugeordnet ist.

Die IGrouping<TKey, TElement> Objekte werden zurückgegeben, die in einer Reihenfolge basierend auf der Reihenfolge der Elemente im source erzeugt den ersten Schlüssel der einzelnen IGrouping<TKey, TElement>. Elemente in einer Gruppierung werden in der Reihenfolge zurückgegeben, dass source.

Wenn comparer ist null, den Standardgleichheitsvergleich Default zum Vergleichen von Schlüsseln verwendet wird.

Wenn zwei Schlüssel als gleich bestimmt werden comparer, ist der erste Schlüssel als Schlüssel für die Gruppierung ausgewählt.

In der Abfrageausdruckssyntax ein group by (Visual C#) oder Group By Into (Visual Basic)-Klausel übersetzt in einen Aufruf von GroupBy. Weitere Informationen und Verwendungsbeispiele finden Sie unter group-Klausel (C#-Referenz) und GROUP BY-Klausel (Visual Basic).

Universelle Windows-Plattform
Verfügbar seit 8
.NET Framework
Verfügbar seit 3.5
Portierbare Klassenbibliothek
Unterstützt in: portierbare .NET-Plattformen
Silverlight
Verfügbar seit 2.0
Windows Phone Silverlight
Verfügbar seit 7.0
Windows Phone
Verfügbar seit 8.1
Zurück zum Anfang
Anzeigen: