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

Queryable.GroupBy<TSource, TKey>-Methode: (IQueryable<TSource>, Expression<Func<TSource, TKey>>)

 

Veröffentlicht: Oktober 2016

Gruppiert die Elemente einer Sequenz entsprechend einer angegebenen Schlüsselauswahlfunktion.

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

public static IQueryable<IGrouping<TKey, TSource>> GroupBy<TSource, TKey>(
	this IQueryable<TSource> source,
	Expression<Func<TSource, TKey>> keySelector
)

Parameter

source
Type: System.Linq.IQueryable<TSource>

Ein IQueryable<T> deren Elemente gruppiert.

keySelector
Type: System.Linq.Expressions.Expression<Func<TSource, TKey>>

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

Rückgabewert

Type: System.Linq.IQueryable<IGrouping<TKey, TSource>>

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

Typparameter

TSource

Der Typ der Elemente von source.

TKey

Der Typ des Schlüssels, der von der Funktion dargestellt zurückgegeben keySelector.

Exception Condition
ArgumentNullException

source oder keySelector ist null.

Diese Methode verfügt über mindestens einen Parameter vom Typ Expression<TDelegate> deren Typargument ist eines der Func<T, TResult> Typen. Für diese Parameter können Sie einen Lambda-Ausdruck übergeben, und es werden kompiliert, um eine Expression<TDelegate>.

Die GroupBy<TSource, TKey>(IQueryable<TSource>, Expression<Func<TSource, TKey>>) -Methode generiert eine MethodCallExpression Aufruf darstellt GroupBy<TSource, TKey>(IQueryable<TSource>, Expression<Func<TSource, TKey>>) sich selbst als konstruierte generische Methode. Anschließend übergibt der MethodCallExpression zu der CreateQuery<TElement>(Expression) Methode der IQueryProvider durch dargestellt die Provider Eigenschaft der source Parameter.

Das Abfrageverhalten durch das Ausführen einer Ausdrucksbaumstruktur, die aufrufende darstellt, GroupBy<TSource, TKey>(IQueryable<TSource>, Expression<Func<TSource, TKey>>) hängt von der Implementierung des Typs der source Parameter. Das erwartete Verhalten ist, dass die Elemente gruppiert source durch einen Wert, der durch den Aufruf abgerufen wird keySelector für jedes Element.

Im folgenden Codebeispiel wird veranschaulicht, wie Sie GroupBy<TSource, TKey>(IQueryable<TSource>, Expression<Func<TSource, TKey>>) die Elemente einer Sequenz gruppieren.

class Pet
{
    public string Name { get; set; }
    public int Age { get; set; }
}

public static void GroupByEx1()
{
    // Create a list of Pet objects.
    List<Pet> pets =
        new List<Pet>{ new Pet { Name="Barley", Age=8 },
                       new Pet { Name="Boots", Age=4 },
                       new Pet { Name="Whiskers", Age=1 },
                       new Pet { Name="Daisy", Age=4 } };

    // Group the pets using Pet.Age as the key.
    // Use Pet.Name as the value for each entry.
    var query = pets.AsQueryable().GroupBy(pet => pet.Age);

    // Iterate over each IGrouping in the collection.
    foreach (var ageGroup in query)
    {
        Console.WriteLine("Age group: {0}  Number of pets: {1}", ageGroup.Key, ageGroup.Count());
    }
}

/*
    This code produces the following output:

    Age group: 8  Number of pets: 1
    Age group: 4  Number of pets: 2
    Age group: 1  Number of pets: 1

*/

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.1
Windows Phone
Verfügbar seit 8.1
Zurück zum Anfang
Anzeigen: