Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C#

Enumerable.GroupBy — raggruppare per chiave

Enumerable.GroupBy divide una sequenza in gruppi usando una chiave selezionata. Ogni gruppo espone la propria chiave tramite Key e i suoi elementi possono essere enumerati direttamente come sequenza.

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

Sintassi

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

Enumerable.GroupBy di System.Linq raggruppa in base a keySelector. Senza elementSelector conserva gli elementi sorgente; con questo selettore memorizza i valori proiettati.

Questi overload restituiscono IEnumerable<IGrouping<TKey,TElement>>. IGrouping<TKey,TElement> implementa IEnumerable<TElement>: il gruppo stesso è la sequenza degli elementi, non un oggetto con una raccolta Values separata. La proprietà IGrouping<TKey,TElement>.Key restituisce la chiave condivisa. Senza proiezione, TElement è il tipo dell’elemento sorgente.

L’esecuzione è differita fino all’enumerazione. I gruppi seguono l’ordine della prima comparsa delle chiavi e gli elementi mantengono l’ordine sorgente; le chiavi non vengono ordinate. Per impostazione predefinita si usa EqualityComparer<TKey>.Default; per un confronto diverso, specifica IEqualityComparer<TKey>.

L’esempio .NET 10 raggruppa le parole in base alla lunghezza. group.Key è la lunghezza, e elements fa riferimento al gruppo stesso.

Esempi

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)}");
}

Risultato

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

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti