Enumerable.GroupBy<TSource, TKey> (Método) (IEnumerable<TSource>, Func<TSource, TKey>, IEqualityComparer<TKey>)

public static IEnumerable<IGrouping<TKey, TSource>> GroupBy<TSource, TKey>(
	this IEnumerable<TSource> source,
	Func<TSource, TKey> keySelector,
	IEqualityComparer<TKey> comparer
)

Nota sobre el uso

Este método se implementa usando la ejecución diferida. El valor devuelto inmediato es un objeto que almacena toda la información necesaria para realizar la acción. La consulta representada por este método no se ejecuta hasta que se enumera el objeto mediante una llamada directa a su método GetEnumerator o a través de foreach en Visual C# o For Each en Visual Basic.

El método GroupBy<TSource, TKey>(IEnumerable<TSource>, Func<TSource, TKey>, IEqualityComparer<TKey>) devuelve una colección de objetos IGrouping<TKey, TElement>, uno por cada una de las distintas claves encontradas. IGrouping<TKey, TElement> es una interfaz IEnumerable<T> que también tiene una clave asociada a sus elementos.

Los objetos IGrouping<TKey, TElement> se proporcionan en un orden que se establece de acuerdo con el orden que siguen los elementos en el parámetro source que produjo la primera clave de cada IGrouping<TKey, TElement>. Los elementos de una agrupación se proporcionan en el orden en que aparecen en source.

Si el valor de comparer es null, se usa el comparador de igualdad predeterminado Default para comparar claves.

Si dos claves se consideran iguales según comparer, la primera clave se elige como clave de esa agrupación.

En la sintaxis de las expresiones de consulta, una cláusula group by (Visual C#) o Group By Into (Visual Basic) se convierte en una invocación de GroupBy. Para obtener más información y ejemplos de uso, vea group (Cláusula, Referencia de C#) y Group By (Cláusula, Visual Basic).

.NET Framework

.NET Framework Client Profile

Biblioteca de clases portable

.NET para aplicaciones de la Tienda Windows

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con SP1 o versiones posteriores; no se admite Itanium)

Referencia

Otros recursos