Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes