Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / C#

Enumerable.GroupBy — agrupar por clave

Enumerable.GroupBy divide una secuencia en grupos usando una clave seleccionada. Cada grupo expone su clave mediante Key, y sus elementos se pueden recorrer directamente como una secuencia.

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

Sintaxis

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

Enumerable.GroupBy, de System.Linq, agrupa según keySelector. Sin elementSelector, conserva los elementos de origen; con este selector, almacena sus valores proyectados.

Estas sobrecargas devuelven IEnumerable<IGrouping<TKey,TElement>>. IGrouping<TKey,TElement> implementa IEnumerable<TElement>: el propio grupo es la secuencia de elementos, no un objeto con una colección Values independiente. La propiedad IGrouping<TKey,TElement>.Key devuelve la clave compartida. Sin proyección, TElement es el tipo del elemento de origen.

La ejecución se aplaza hasta la enumeración. Los grupos siguen el orden en que aparecen sus claves por primera vez y los elementos conservan el orden de origen; las claves no se ordenan. De forma predeterminada se usa EqualityComparer<TKey>.Default; para otra comparación, se puede proporcionar IEqualityComparer<TKey>.

El ejemplo de .NET 10 agrupa palabras por longitud. group.Key es la longitud, y elements hace referencia al propio grupo.

Ejemplos

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

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes