Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Metodo Queryable.GroupBy<TSource, TKey>(IQueryable<TSource>, Expression<Func<TSource, TKey>>)

 

Data di pubblicazione: ottobre 2016

Raggruppa gli elementi di una sequenza secondo una specificata funzione del selettore di chiave.

Spazio dei nomi:   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
)

Parametri

source
Type: System.Linq.IQueryable<TSource>

Un IQueryable<T> cui raggruppare gli elementi.

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

Funzione per estrarre la chiave per ogni elemento.

Valore restituito

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

Un IQueryable<IGrouping<TKey, TSource>> in c# o IQueryable(Of IGrouping(Of TKey, TSource)) in Visual Basic in cui ogni IGrouping<TKey, TElement> oggetto contiene una sequenza di oggetti e una chiave.

Parametri tipo

TSource

Tipo degli elementi di source.

TKey

Il tipo della chiave restituita dalla funzione rappresentata keySelector.

Exception Condition
ArgumentNullException

source o keySelector è null.

Questo metodo contiene almeno un parametro di tipo Expression<TDelegate> il cui argomento di tipo è uno del Func<T, TResult> tipi. Per questi parametri, è possibile passare un'espressione lambda e verrà compilato in un Expression<TDelegate>.

Il GroupBy<TSource, TKey>(IQueryable<TSource>, Expression<Func<TSource, TKey>>) metodo genera un MethodCallExpression che rappresenta una chiamata GroupBy<TSource, TKey>(IQueryable<TSource>, Expression<Func<TSource, TKey>>) stesso come un metodo generico costruito. Passa quindi il MethodCallExpression per il CreateQuery<TElement>(Expression) metodo il IQueryProvider rappresentato dal Provider proprietà del source parametro.

Il comportamento della query che si verifica in seguito all'esecuzione di una struttura ad albero dell'espressione che rappresenta una chiamata GroupBy<TSource, TKey>(IQueryable<TSource>, Expression<Func<TSource, TKey>>) dipende dall'implementazione del tipo di source parametro. Il comportamento previsto è che raggruppa gli elementi di source dal valore di chiave ottenuto richiamando keySelector su ogni elemento.

Esempio di codice seguente viene illustrato come utilizzare GroupBy<TSource, TKey>(IQueryable<TSource>, Expression<Func<TSource, TKey>>) per raggruppare gli elementi di una sequenza.

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

*/

Universal Windows Platform
Disponibile da 8
.NET Framework
Disponibile da 3.5
Libreria di classi portabile
Supportato in: piattaforme .NET portabili
Silverlight
Disponibile da 2.0
Windows Phone Silverlight
Disponibile da 7.1
Windows Phone
Disponibile da 8.1
Torna all'inizio
Mostra: