CKTIS / C#
Enumerable.GroupBy — agrupar por chave
Enumerable.GroupBy divide uma sequência em grupos usando uma chave selecionada. Cada grupo expõe a respetiva chave através de Key, e os seus elementos podem ser percorridos diretamente como uma sequência.
Versão: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Sintaxe
IEnumerable<IGrouping<TKey, TSource>> groups = source.GroupBy(keySelector);
IEnumerable<IGrouping<TKey, TElement>> groups = source.GroupBy(keySelector, elementSelector);Enumerable.GroupBy, de System.Linq, agrupa com base em keySelector. Sem elementSelector, mantém os elementos de origem; com este seletor, guarda os respetivos valores projetados.
Estas sobrecargas devolvem IEnumerable<IGrouping<TKey,TElement>>. IGrouping<TKey,TElement> implementa IEnumerable<TElement>: o próprio grupo é a sequência de elementos, não um objeto com uma coleção Values separada. A propriedade IGrouping<TKey,TElement>.Key devolve a chave comum. Sem projeção, TElement é o tipo do elemento de origem.
A execução é diferida até à enumeração. Os grupos seguem a ordem da primeira ocorrência das chaves, e os elementos mantêm a ordem de origem; as chaves não são ordenadas. Por predefinição, é usado EqualityComparer<TKey>.Default; para outra comparação, pode ser fornecido IEqualityComparer<TKey>.
O exemplo de .NET 10 agrupa palavras por comprimento. group.Key é o comprimento, e elements refere-se ao próprio grupo.
Exemplos
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)}");
}Resultado
4: pear, plum, kiwi 3: fig, tea
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.