Enumerable.GroupBy Método

Definição

Namespace:

System.Linq

Assembly:

System.Linq.dll

Agrupa os elementos de uma sequência.

Sobrecargas

GroupBy<TSource,TKey,TElement,TResult>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>, Func<TKey,IEnumerable<TElement>,TResult>)	Agrupa os elementos de uma sequência de acordo com uma função do seletor de chave especificada e cria um valor de resultado de cada grupo e sua chave. Os elementos de cada grupo são projetados usando uma função especificada.
GroupBy<TSource,TKey,TElement,TResult>(IEnumerable<TSource>, Func<TSource, TKey>, Func<TSource,TElement>, Func<TKey,IEnumerable<TElement>, TResult>, IEqualityComparer<TKey>)	Agrupa os elementos de uma sequência de acordo com uma função do seletor de chave especificada e cria um valor de resultado de cada grupo e sua chave. Os valores da chave são comparados usando um comparador especificado e os elementos de cada grupo são projetados usando uma função especificada.
GroupBy<TSource,TKey,TElement>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>)	Agrupa os elementos de uma sequência de acordo com a função de seletor de chave especificada e projeta os elementos de cada grupo usando uma função especificada.
GroupBy<TSource,TKey,TElement>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>, IEqualityComparer<TKey>)	Agrupa os elementos de uma sequência de acordo com uma função de seletor de chave. As chaves são comparadas usando um comparador e os elementos de cada grupo são projetados usando uma função especificada.
GroupBy<TSource,TKey,TResult>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TKey,IEnumerable<TSource>,TResult>)	Agrupa os elementos de uma sequência de acordo com uma função do seletor de chave especificada e cria um valor de resultado de cada grupo e sua chave.
GroupBy<TSource,TKey,TResult>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TKey,IEnumerable<TSource>,TResult>, IEqualityComparer<TKey>)	Agrupa os elementos de uma sequência de acordo com uma função do seletor de chave especificada e cria um valor de resultado de cada grupo e sua chave. As chaves são comparadas usando um comparador especificado.
GroupBy<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>)	Agrupa os elementos de uma sequência de acordo com uma função de seletor de chave especificada.
GroupBy<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>, IEqualityComparer<TKey>)	Agrupa os elementos de uma sequência de acordo com uma função do seletor de chave especificada e compara as chaves usando um comparador especificado.

GroupBy<TSource,TKey,TElement,TResult>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>, Func<TKey,IEnumerable<TElement>,TResult>)

Origem:

Grouping.cs

Agrupa os elementos de uma sequência de acordo com uma função do seletor de chave especificada e cria um valor de resultado de cada grupo e sua chave. Os elementos de cada grupo são projetados usando uma função especificada.

C#

public static System.Collections.Generic.IEnumerable<TResult> GroupBy<TSource,TKey,TElement,TResult> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,TKey> keySelector, Func<TSource,TElement> elementSelector, Func<TKey,System.Collections.Generic.IEnumerable<TElement>,TResult> resultSelector);

Parâmetros de tipo

TSource

O tipo dos elementos de source.

TKey

O tipo da chave retornada por keySelector.

TElement

O tipo dos elementos em cada IGrouping<TKey,TElement>.

TResult

O tipo do valor de resultado retornado por resultSelector.

Parâmetros

source

IEnumerable<TSource>

Um IEnumerable<T> cujos elementos serão agrupados.

keySelector

Func<TSource,TKey>

Uma função para extrair a chave de cada elemento.

elementSelector

Func<TSource,TElement>

Uma função para mapear cada elemento de origem para um elemento em um IGrouping<TKey,TElement>.

resultSelector

Func<TKey,IEnumerable<TElement>,TResult>

Uma função para criar um valor de resultado de cada grupo.

Retornos

IEnumerable<TResult>

Uma coleção de elementos do tipo TResult, em que cada elemento representa uma projeção em um grupo e sua chave.

Exceções

ArgumentNullException

source ou keySelector ou elementSelector ou resultSelector é null.

Exemplos

O exemplo de código a seguir demonstra como usar GroupBy<TSource,TKey,TElement,TResult>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>, Func<TKey,IEnumerable<TElement>,TResult>) para agrupar os elementos projetados de uma sequência e, em seguida, projetar uma sequência de resultados do tipo TResult.

C#

class Pet
{
    public string Name { get; set; }
    public double Age { get; set; }
}

public static void GroupByEx4()
{
    // Create a list of pets.
    List<Pet> petsList =
        new List<Pet>{ new Pet { Name="Barley", Age=8.3 },
                       new Pet { Name="Boots", Age=4.9 },
                       new Pet { Name="Whiskers", Age=1.5 },
                       new Pet { Name="Daisy", Age=4.3 } };

    // Group Pet.Age values by the Math.Floor of the age.
    // Then project an anonymous type from each group
    // that consists of the key, the count of the group's
    // elements, and the minimum and maximum age in the group.
    var query = petsList.GroupBy(
        pet => Math.Floor(pet.Age),
        pet => pet.Age,
        (baseAge, ages) => new
        {
            Key = baseAge,
            Count = ages.Count(),
            Min = ages.Min(),
            Max = ages.Max()
        });

    // Iterate over each anonymous type.
    foreach (var result in query)
    {
        Console.WriteLine("\nAge group: " + result.Key);
        Console.WriteLine("Number of pets in this age group: " + result.Count);
        Console.WriteLine("Minimum age: " + result.Min);
        Console.WriteLine("Maximum age: " + result.Max);
    }

    /*  This code produces the following output:

        Age group: 8
        Number of pets in this age group: 1
        Minimum age: 8.3
        Maximum age: 8.3

        Age group: 4
        Number of pets in this age group: 2
        Minimum age: 4.3
        Maximum age: 4.9

        Age group: 1
        Number of pets in this age group: 1
        Minimum age: 1.5
        Maximum age: 1.5
    */
}

Comentários

Na sintaxe da expressão de consulta, uma group by cláusula (C#) ou Group By Into (Visual Basic) é convertida em uma invocação de GroupBy.

Confira também

• Cláusula group (Referência de C#)
• Cláusula Group By (Visual Basic)

GroupBy<TSource,TKey,TElement,TResult>(IEnumerable<TSource>, Func<TSource, TKey>, Func<TSource,TElement>, Func<TKey,IEnumerable<TElement>, TResult>, IEqualityComparer<TKey>)

Origem:

Grouping.cs

Agrupa os elementos de uma sequência de acordo com uma função do seletor de chave especificada e cria um valor de resultado de cada grupo e sua chave. Os valores da chave são comparados usando um comparador especificado e os elementos de cada grupo são projetados usando uma função especificada.

C#

public static System.Collections.Generic.IEnumerable<TResult> GroupBy<TSource,TKey,TElement,TResult> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,TKey> keySelector, Func<TSource,TElement> elementSelector, Func<TKey,System.Collections.Generic.IEnumerable<TElement>,TResult> resultSelector, System.Collections.Generic.IEqualityComparer<TKey>? comparer);

Parâmetros de tipo

TSource

O tipo dos elementos de source.

TKey

O tipo da chave retornada por keySelector.

TElement

O tipo dos elementos em cada IGrouping<TKey,TElement>.

TResult

O tipo do valor de resultado retornado por resultSelector.

Parâmetros

source

IEnumerable<TSource>

Um IEnumerable<T> cujos elementos serão agrupados.

keySelector

Func<TSource,TKey>

Uma função para extrair a chave de cada elemento.

elementSelector

Func<TSource,TElement>

Uma função para mapear cada elemento de origem para um elemento em um IGrouping<TKey,TElement>.

resultSelector

Func<TKey,IEnumerable<TElement>,TResult>

Uma função para criar um valor de resultado de cada grupo.

comparer

IEqualityComparer<TKey>

Um IEqualityComparer<T> com o qual as chaves serão comparadas.

Retornos

IEnumerable<TResult>

Uma coleção de elementos do tipo TResult, em que cada elemento representa uma projeção em um grupo e sua chave.

Exceções

ArgumentNullException

source ou keySelector ou elementSelector ou resultSelector é null.

Confira também

• Cláusula group (Referência de C#)
• Cláusula Group By (Visual Basic)

GroupBy<TSource,TKey,TElement>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>)

Origem:

Grouping.cs

Agrupa os elementos de uma sequência de acordo com a função de seletor de chave especificada e projeta os elementos de cada grupo usando uma função especificada.

C#

public static System.Collections.Generic.IEnumerable<System.Linq.IGrouping<TKey,TElement>> GroupBy<TSource,TKey,TElement> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,TKey> keySelector, Func<TSource,TElement> elementSelector);

Parâmetros de tipo

TSource

O tipo dos elementos de source.

TKey

O tipo da chave retornada por keySelector.

TElement

O tipo dos elementos no IGrouping<TKey,TElement>.

Parâmetros

source

IEnumerable<TSource>

Um IEnumerable<T> cujos elementos serão agrupados.

keySelector

Func<TSource,TKey>

Uma função para extrair a chave de cada elemento.

elementSelector

Func<TSource,TElement>

Uma função para mapear cada elemento de origem para um elemento no IGrouping<TKey,TElement>.

Retornos

IEnumerable<IGrouping<TKey,TElement>>

Um IEnumerable<IGrouping<TKey, TElement>> em C# ou IEnumerable(Of IGrouping(Of TKey, TElement)) no Visual Basic em que cada IGrouping<TKey,TElement> objeto contém uma coleção de objetos do tipo TElement e uma chave.

Exceções

ArgumentNullException

source, keySelector ou elementSelector é null.

Exemplos

O exemplo de código a seguir demonstra como usar GroupBy<TSource,TKey,TElement>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>) para agrupar os elementos de uma sequência.

C#

class Pet
{
    public string Name { get; set; }
    public int Age { get; set; }
}

// Uses method-based query syntax.
public static void GroupByEx1()
{
    // Create a list of pets.
    List<Pet> pets =
        new List<Pet>{ new Pet { Name="Barley", Age=8 },
                       new Pet { Name="Boots", Age=4 },
                       new Pet { Name="Whiskers", Age=1 },
                       new Pet { Name="Daisy", Age=4 } };

    // Group the pets using Age as the key value
    // and selecting only the pet's Name for each value.
    IEnumerable<IGrouping<int, string>> query =
        pets.GroupBy(pet => pet.Age, pet => pet.Name);

    // Iterate over each IGrouping in the collection.
    foreach (IGrouping<int, string> petGroup in query)
    {
        // Print the key value of the IGrouping.
        Console.WriteLine(petGroup.Key);
        // Iterate over each value in the
        // IGrouping and print the value.
        foreach (string name in petGroup)
            Console.WriteLine("  {0}", name);
    }
}

/*
 This code produces the following output:

 8
   Barley
 4
   Boots
   Daisy
 1
   Whiskers
*/

Na sintaxe da expressão de consulta, uma group by cláusula (C#) ou Group By Into (Visual Basic) é convertida em uma invocação de GroupBy. A tradução da expressão de consulta no exemplo a seguir é equivalente à consulta no exemplo acima.

C#

IEnumerable<IGrouping<int, string>> query =
    from pet in pets
    group pet.Name by pet.Age;

Observação

Em uma expressão de consulta C# ou Visual Basic, as expressões de seleção de elemento e chave ocorrem na ordem inversa de suas posições de argumento em uma chamada para o GroupBy<TSource,TKey,TElement>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>) método .

Comentários

Esse método é implementado usando a execução adiada. O valor retornado imediato é um objeto que armazena todas as informações necessárias para executar a ação. A consulta representada por esse método não é executada até que o objeto seja enumerado chamando seu GetEnumerator método diretamente ou usando foreach em C# ou For Each no Visual Basic.

O GroupBy<TSource,TKey,TElement>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>) método retorna uma coleção de IGrouping<TKey,TElement> objetos, um para cada chave distinta que foi encontrada. Um IGrouping<TKey,TElement> é um IEnumerable<T> que também tem uma chave associada aos seus elementos.

Os IGrouping<TKey,TElement> objetos são produzidos em uma ordem com base na ordem dos elementos no source que produziu a primeira chave de cada IGrouping<TKey,TElement>. Os elementos em um agrupamento são produzidos na ordem em que os elementos que os produziram aparecem em source.

O comparador Default de igualdade padrão é usado para comparar chaves.

Confira também

• Cláusula group (Referência de C#)
• Cláusula Group By (Visual Basic)

GroupBy<TSource,TKey,TElement>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>, IEqualityComparer<TKey>)

Origem:

Grouping.cs

Agrupa os elementos de uma sequência de acordo com uma função de seletor de chave. As chaves são comparadas usando um comparador e os elementos de cada grupo são projetados usando uma função especificada.

C#

public static System.Collections.Generic.IEnumerable<System.Linq.IGrouping<TKey,TElement>> GroupBy<TSource,TKey,TElement> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,TKey> keySelector, Func<TSource,TElement> elementSelector, System.Collections.Generic.IEqualityComparer<TKey>? comparer);

Parâmetros de tipo

TSource

O tipo dos elementos de source.

TKey

O tipo da chave retornada por keySelector.

TElement

O tipo dos elementos no IGrouping<TKey,TElement>.

Parâmetros

source

IEnumerable<TSource>

Um IEnumerable<T> cujos elementos serão agrupados.

keySelector

Func<TSource,TKey>

Uma função para extrair a chave de cada elemento.

elementSelector

Func<TSource,TElement>

Uma função para mapear cada elemento de origem para um elemento em um IGrouping<TKey,TElement>.

comparer

IEqualityComparer<TKey>

Um IEqualityComparer<T> para comparar chaves.

Retornos

IEnumerable<IGrouping<TKey,TElement>>

Um IEnumerable<IGrouping<TKey, TElement>> em C# ou IEnumerable(Of IGrouping(Of TKey, TElement)) no Visual Basic em que cada IGrouping<TKey,TElement> objeto contém uma coleção de objetos do tipo TElement e uma chave.

Exceções

ArgumentNullException

source, keySelector ou elementSelector é null.

Comentários

Esse método é implementado usando a execução adiada. O valor retornado imediato é um objeto que armazena todas as informações necessárias para executar a ação. A consulta representada por esse método não é executada até que o objeto seja enumerado chamando seu GetEnumerator método diretamente ou usando foreach em C# ou For Each no Visual Basic.

Observação

Para obter exemplos de GroupBy, consulte os seguintes artigos:

• GroupBy<TSource,TKey,TElement>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>)
• GroupBy<TSource,TKey,TResult>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TKey,IEnumerable<TSource>,TResult>)
• GroupBy<TSource,TKey,TElement,TResult>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>, Func<TKey,IEnumerable<TElement>,TResult>)

O GroupBy<TSource,TKey,TElement>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>, IEqualityComparer<TKey>) método retorna uma coleção de IGrouping<TKey,TElement> objetos, um para cada chave distinta que foi encontrada. Um IGrouping<TKey,TElement> é um IEnumerable<T> que também tem uma chave associada aos seus elementos.

Os IGrouping<TKey,TElement> objetos são produzidos em uma ordem com base na ordem dos elementos no source que produziu a primeira chave de cada IGrouping<TKey,TElement>. Os elementos em um agrupamento são produzidos na ordem em que os elementos que os produziram aparecem em source.

Se comparer for null, o comparador Default de igualdade padrão será usado para comparar chaves.

Se duas chaves forem consideradas iguais de acordo comparercom , a primeira chave será escolhida como a chave para esse agrupamento.

Na sintaxe da expressão de consulta, uma group by cláusula (C#) ou Group By Into (Visual Basic) é convertida em uma invocação de GroupBy. Para obter mais informações e exemplos de uso, consulte cláusula group e Cláusula Group By.

Confira também

• Cláusula group (Referência de C#)
• Cláusula Group By (Visual Basic)

GroupBy<TSource,TKey,TResult>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TKey,IEnumerable<TSource>,TResult>)

Origem:

Grouping.cs

Agrupa os elementos de uma sequência de acordo com uma função do seletor de chave especificada e cria um valor de resultado de cada grupo e sua chave.

C#

public static System.Collections.Generic.IEnumerable<TResult> GroupBy<TSource,TKey,TResult> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,TKey> keySelector, Func<TKey,System.Collections.Generic.IEnumerable<TSource>,TResult> resultSelector);

Parâmetros de tipo

TSource

O tipo dos elementos de source.

TKey

O tipo da chave retornada por keySelector.

TResult

O tipo do valor de resultado retornado por resultSelector.

Parâmetros

source

IEnumerable<TSource>

Um IEnumerable<T> cujos elementos serão agrupados.

keySelector

Func<TSource,TKey>

Uma função para extrair a chave de cada elemento.

resultSelector

Func<TKey,IEnumerable<TSource>,TResult>

Uma função para criar um valor de resultado de cada grupo.

Retornos

IEnumerable<TResult>

Uma coleção de elementos do tipo TResult, em que cada elemento representa uma projeção em um grupo e sua chave.

Exceções

ArgumentNullException

source, keySelector ou resultSelector é null.

Exemplos

O exemplo de código a seguir demonstra como usar GroupBy<TSource,TKey,TResult>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TKey,IEnumerable<TSource>,TResult>) para agrupar os elementos de uma sequência e projetar uma sequência de resultados do tipo TResult.

C#

class Pet
{
    public string Name { get; set; }
    public double Age { get; set; }
}

public static void GroupByEx3()
{
    // Create a list of pets.
    List<Pet> petsList =
        new List<Pet>{ new Pet { Name="Barley", Age=8.3 },
                       new Pet { Name="Boots", Age=4.9 },
                       new Pet { Name="Whiskers", Age=1.5 },
                       new Pet { Name="Daisy", Age=4.3 } };

    // Group Pet objects by the Math.Floor of their age.
    // Then project an anonymous type from each group
    // that consists of the key, the count of the group's
    // elements, and the minimum and maximum age in the group.
    var query = petsList.GroupBy(
        pet => Math.Floor(pet.Age),
        (age, pets) => new
        {
            Key = age,
            Count = pets.Count(),
            Min = pets.Min(pet => pet.Age),
            Max = pets.Max(pet => pet.Age)
        });

    // Iterate over each anonymous type.
    foreach (var result in query)
    {
        Console.WriteLine("\nAge group: " + result.Key);
        Console.WriteLine("Number of pets in this age group: " + result.Count);
        Console.WriteLine("Minimum age: " + result.Min);
        Console.WriteLine("Maximum age: " + result.Max);
    }

    /*  This code produces the following output:

        Age group: 8
        Number of pets in this age group: 1
        Minimum age: 8.3
        Maximum age: 8.3

        Age group: 4
        Number of pets in this age group: 2
        Minimum age: 4.3
        Maximum age: 4.9

        Age group: 1
        Number of pets in this age group: 1
        Minimum age: 1.5
        Maximum age: 1.5
    */
}

Comentários

Na sintaxe da expressão de consulta, uma group by cláusula (C#) ou Group By Into (Visual Basic) é convertida em uma invocação de GroupBy.

Confira também

• Cláusula group (Referência de C#)
• Cláusula Group By (Visual Basic)

GroupBy<TSource,TKey,TResult>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TKey,IEnumerable<TSource>,TResult>, IEqualityComparer<TKey>)

Origem:

Grouping.cs

Agrupa os elementos de uma sequência de acordo com uma função do seletor de chave especificada e cria um valor de resultado de cada grupo e sua chave. As chaves são comparadas usando um comparador especificado.

C#

public static System.Collections.Generic.IEnumerable<TResult> GroupBy<TSource,TKey,TResult> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,TKey> keySelector, Func<TKey,System.Collections.Generic.IEnumerable<TSource>,TResult> resultSelector, System.Collections.Generic.IEqualityComparer<TKey>? comparer);

Parâmetros de tipo

TSource

O tipo dos elementos de source.

TKey

O tipo da chave retornada por keySelector.

TResult

O tipo do valor de resultado retornado por resultSelector.

Parâmetros

source

IEnumerable<TSource>

Um IEnumerable<T> cujos elementos serão agrupados.

keySelector

Func<TSource,TKey>

Uma função para extrair a chave de cada elemento.

resultSelector

Func<TKey,IEnumerable<TSource>,TResult>

Uma função para criar um valor de resultado de cada grupo.

comparer

IEqualityComparer<TKey>

Um IEqualityComparer<T> com o qual as chaves serão comparadas.

Retornos

IEnumerable<TResult>

Uma coleção de elementos do tipo TResult, em que cada elemento representa uma projeção em um grupo e sua chave.

Exceções

ArgumentNullException

source, keySelector ou resultSelector é null.

Confira também

• Cláusula group (Referência de C#)
• Cláusula Group By (Visual Basic)

GroupBy<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>)

Origem:

Grouping.cs

Agrupa os elementos de uma sequência de acordo com uma função de seletor de chave especificada.

C#

public static System.Collections.Generic.IEnumerable<System.Linq.IGrouping<TKey,TSource>> GroupBy<TSource,TKey> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,TKey> keySelector);

Parâmetros de tipo

TSource

O tipo dos elementos de source.

TKey

O tipo da chave retornada por keySelector.

Parâmetros

source

IEnumerable<TSource>

Um IEnumerable<T> cujos elementos serão agrupados.

keySelector

Func<TSource,TKey>

Uma função para extrair a chave de cada elemento.

Retornos

IEnumerable<IGrouping<TKey,TSource>>

Um IEnumerable<IGrouping<TKey, TSource>> em C# ou IEnumerable(Of IGrouping(Of TKey, TSource)) no Visual Basic em que cada IGrouping<TKey,TElement> objeto contém uma sequência de objetos e uma chave.

Exceções

ArgumentNullException

source ou keySelector é null.

Comentários

Esse método é implementado usando a execução adiada. O valor retornado imediato é um objeto que armazena todas as informações necessárias para executar a ação. A consulta representada por esse método não é executada até que o objeto seja enumerado chamando seu GetEnumerator método diretamente ou usando foreach em C# ou For Each no Visual Basic.

Observação

Para obter exemplos de GroupBy, consulte os seguintes artigos:

• GroupBy<TSource,TKey,TElement>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>)
• GroupBy<TSource,TKey,TResult>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TKey,IEnumerable<TSource>,TResult>)
• GroupBy<TSource,TKey,TElement,TResult>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>, Func<TKey,IEnumerable<TElement>,TResult>)

O GroupBy<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>) método retorna uma coleção de IGrouping<TKey,TElement> objetos, um para cada chave distinta que foi encontrada. Um IGrouping<TKey,TElement> é um IEnumerable<T> que também tem uma chave associada aos seus elementos.

Os IGrouping<TKey,TElement> objetos são produzidos em uma ordem com base na ordem dos elementos no source que produziu a primeira chave de cada IGrouping<TKey,TElement>. Os elementos em um agrupamento são gerados na ordem em que aparecem em source.

O comparador Default de igualdade padrão é usado para comparar chaves.

Na sintaxe da expressão de consulta, uma group by cláusula (C#) ou Group By Into (Visual Basic) é convertida em uma invocação de GroupBy. Para obter mais informações e exemplos de uso, consulte cláusula group e Cláusula Group By.

Confira também

• Cláusula group (Referência de C#)
• Cláusula Group By (Visual Basic)

GroupBy<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>, IEqualityComparer<TKey>)

Origem:

Grouping.cs

Agrupa os elementos de uma sequência de acordo com uma função do seletor de chave especificada e compara as chaves usando um comparador especificado.

C#

public static System.Collections.Generic.IEnumerable<System.Linq.IGrouping<TKey,TSource>> GroupBy<TSource,TKey> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,TKey> keySelector, System.Collections.Generic.IEqualityComparer<TKey>? comparer);

Parâmetros de tipo

TSource

O tipo dos elementos de source.

TKey

O tipo da chave retornada por keySelector.

Parâmetros

source

IEnumerable<TSource>

Um IEnumerable<T> cujos elementos serão agrupados.

keySelector

Func<TSource,TKey>

Uma função para extrair a chave de cada elemento.

comparer

IEqualityComparer<TKey>

Um IEqualityComparer<T> para comparar chaves.

Retornos

IEnumerable<IGrouping<TKey,TSource>>

Um IEnumerable<IGrouping<TKey, TSource>> em C# ou IEnumerable(Of IGrouping(Of TKey, TSource)) no Visual Basic em que cada IGrouping<TKey,TElement> objeto contém uma coleção de objetos e uma chave.

Exceções

ArgumentNullException

source ou keySelector é null.

Comentários

Esse método é implementado usando a execução adiada. O valor retornado imediato é um objeto que armazena todas as informações necessárias para executar a ação. A consulta representada por esse método não é executada até que o objeto seja enumerado chamando seu GetEnumerator método diretamente ou usando foreach em C# ou For Each no Visual Basic.

Observação

Para obter exemplos de GroupBy, consulte os seguintes artigos:

• GroupBy<TSource,TKey,TElement>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>)
• GroupBy<TSource,TKey,TResult>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TKey,IEnumerable<TSource>,TResult>)
• GroupBy<TSource,TKey,TElement,TResult>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>, Func<TKey,IEnumerable<TElement>,TResult>)

O GroupBy<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>, IEqualityComparer<TKey>) método retorna uma coleção de IGrouping<TKey,TElement> objetos, um para cada chave distinta que foi encontrada. Um IGrouping<TKey,TElement> é um IEnumerable<T> que também tem uma chave associada aos seus elementos.

Os IGrouping<TKey,TElement> objetos são produzidos em uma ordem com base na ordem dos elementos no source que produziu a primeira chave de cada IGrouping<TKey,TElement>. Os elementos em um agrupamento são gerados na ordem em que aparecem em source.

Se comparer for null, o comparador Default de igualdade padrão será usado para comparar chaves.

Se duas chaves forem consideradas iguais de acordo comparercom , a primeira chave será escolhida como a chave para esse agrupamento.

Na sintaxe da expressão de consulta, uma group by cláusula (C#) ou Group By Into (Visual Basic) é convertida em uma invocação de GroupBy. Para obter mais informações e exemplos de uso, consulte cláusula group e Cláusula Group By.

Confira também

• Cláusula group (Referência de C#)
• Cláusula Group By (Visual Basic)