Esporta (0) Stampa
Espandi tutto
Il presente articolo è stato tradotto automaticamente. Passare il puntatore sulle frasi nell'articolo per visualizzare il testo originale. Ulteriori informazioni.
Traduzione
Originale

Metodo Enumerable.GroupBy<TSource, TKey, TElement> (IEnumerable<TSource>, Func<TSource, TKey>, Func<TSource, TElement>)

Raggruppa gli elementi di una sequenza in base a una funzione specificata del selettore di chiave e proietta gli elementi di ogni gruppo utilizzando una funzione specificata.

Spazio dei nomi:  System.Linq
Assembly:  System.Core (in 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
)

Parametri di tipo

TSource

Tipo degli elementi di source.

TKey

Tipo della chiave restituita dall'oggetto keySelector.

TElement

Tipo degli elementi contenuti nell’oggetto IGrouping<TKey, TElement>.

Parametri

source
Tipo: System.Collections.Generic.IEnumerable<TSource>
Oggetto IEnumerable<T> i cui elementi sono da raggruppare.
keySelector
Tipo: System.Func<TSource, TKey>
Funzione per estrarre la chiave per ogni elemento.
elementSelector
Tipo: System.Func<TSource, TElement>
Funzione per eseguire il mapping di ogni elemento di origine a un elemento nell’oggetto IGrouping<TKey, TElement>.

Valore restituito

Tipo: System.Collections.Generic.IEnumerable<IGrouping<TKey, TElement>>
Oggetto IEnumerable<IGrouping<TKey, TElement>> in C# o IEnumerable(Of IGrouping(Of TKey, TElement)) in Visual Basic dove ogni oggetto IGrouping<TKey, TElement> contiene una raccolta di oggetti di tipo TElement e una chiave.

Nota sull'utilizzo

In Visual Basic e C# è possibile chiamare questo metodo come metodo di istanza su qualsiasi oggetto di tipo IEnumerable<TSource>. Per chiamare il metodo utilizzando la sintassi del metodo di istanza, omettere il primo parametro. Per ulteriori informazioni, vedere Metodi di estensione (Visual Basic) o Metodi di estensione (Guida per programmatori C#).

EccezioneCondizione
ArgumentNullException

source o keySelector o elementSelector è null.

Questo metodo viene implementato tramite esecuzione posticipata. Il valore restituito immediato è un oggetto che contiene tutte le informazioni necessarie all'esecuzione dell'azione. La query rappresentata da questo metodo non viene eseguita finché l'oggetto non viene enumerato tramite chiamata diretta al relativo metodo GetEnumerator o utilizzando l'oggetto foreach in Visual C# oppure For Each in Visual Basic.

Il metodo GroupBy<TSource, TKey, TElement>(IEnumerable<TSource>, Func<TSource, TKey>, Func<TSource, TElement>) restituisce una raccolta di oggetti IGrouping<TKey, TElement>, uno per ogni chiave diversa trovata. Oggetto IGrouping<TKey, TElement> è un IEnumerable<T> che dispone anche di una chiave associata agli elementi.

Gli oggetti IGrouping<TKey, TElement> sono prodotti in un ordine basato sull'ordine degli elementi in source che produce la prima chiave di ogni IGrouping<TKey, TElement>. Gli elementi in un raggruppamento vengono restituiti nell'ordine in cui gli elementi che li hanno prodotti sono presenti in source.

Per il confronto delle chiavi viene utilizzato l'operatore di confronto uguaglianze predefinito Default.

Nell'esempio di codice riportato di seguito viene illustrato come utilizzare l'oggetto GroupBy<TSource, TKey, TElement>(IEnumerable<TSource>, Func<TSource, TKey>, Func<TSource, TElement>) per raggruppare gli elementi di una sequenza.


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

            // Uses method-based query syntax.
            public static void GroupByEx1()
            {
                // Create a list of pets.
                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 Age as the key value 
                // and selecting only the pet's Name for each value.
                IEnumerable<IGrouping<int, string>> query =
                    pets.GroupBy(pet => pet.Age, pet => pet.Name);

                // Iterate over each IGrouping in the collection.
                foreach (IGrouping<int, string> petGroup in query)
                {
                    // Print the key value of the IGrouping.
                    Console.WriteLine(petGroup.Key);
                    // Iterate over each value in the 
                    // IGrouping and print the value.
                    foreach (string name in petGroup)
                        Console.WriteLine("  {0}", name);
                }
            }

            /*
             This code produces the following output:

             8
               Barley
             4
               Boots
               Daisy
             1
               Whiskers
            */



Nella sintassi di una espressione di query, una clausola group by (Visual C#) o Group By Into (Visual Basic) viene convertita in una chiamata di GroupBy. La conversione dell'espressione di query nell'esempio seguente equivale alla query contenuta nell'esempio precedente.


IEnumerable<IGrouping<int, string>> query =
    from pet in pets
    group pet.Name by pet.Age;


NotaNota

In una espressione di query di Visual C# o Visual Basic, l'elemento e le espressioni di selezione della chiave si verificano in ordine inverso rispetto alle posizioni degli argomenti in una chiamata al metodo GroupBy<TSource, TKey, TElement>(IEnumerable<TSource>, Func<TSource, TKey>, Func<TSource, TElement>).

.NET Framework

Supportato in: 4.5.2, 4.5.1, 4.5, 4, 3.5

.NET Framework Client Profile

Supportato in: 4, 3.5 SP1

Libreria di classi portabile

Supportato in: Libreria di classi portabile

.NET per applicazioni Windows Store

Supportato in: Windows 8

.NET per applicazioni Windows Phone

Supportato in: Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (ruoli di base del server non supportati), Windows Server 2008 R2 (ruoli di base del server supportati con SP1 o versione successiva, Itanium non supportato)

.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.

Aggiunte alla community

AGGIUNGI
Microsoft sta conducendo un sondaggio in linea per comprendere l'opinione degli utenti in merito al sito Web di MSDN. Se si sceglie di partecipare, quando si lascia il sito Web di MSDN verrà visualizzato il sondaggio in linea.

Si desidera partecipare?
Mostra:
© 2014 Microsoft