Compartilhar via

Cláusula Agrupar por (Visual Basic)

Agrupa os elementos de um resultado de consulta. Também pode ser usado para aplicar funções de agregação a cada grupo. A operação de agrupamento é baseada em uma ou mais chaves.

Sintaxe

Group [ listField1 [, listField2 [...] ] By keyExp1 [, keyExp2 [...] ]  
  Into aggregateList

Partes

  • listField1, listField2

    Opcional. Um ou mais campos da variável de consulta ou variáveis que identificam explicitamente os campos a serem incluídos no resultado agrupado. Se nenhum campo for especificado, todos os campos da variável de consulta ou variáveis serão incluídos no resultado agrupado.

  • keyExp1

    Obrigatório Uma expressão que identifica a chave a ser usada para determinar os grupos de elementos. Você pode especificar mais de uma chave para especificar uma chave composta.

  • keyExp2

    Opcional. Uma ou mais chaves adicionais que são combinadas keyExp1 para criar uma chave composta.

  • aggregateList

    Obrigatório Uma ou mais expressões que identificam como os grupos são agregados. Para identificar um nome de membro para os resultados agrupados, use a Group palavra-chave, que pode estar em qualquer um dos seguintes formulários:

    Into Group

    - ou -

    Into <alias> = Group

    Você também pode incluir funções de agregação a serem aplicadas ao grupo.

Observações

Você pode usar a Group By cláusula para dividir os resultados de uma consulta em grupos. O agrupamento é baseado em uma chave ou uma chave composta que consiste em várias chaves. Os elementos associados aos valores de chave correspondentes são incluídos no mesmo grupo.

Use o aggregateList parâmetro da Into cláusula e a Group palavra-chave para identificar o nome do membro usado para fazer referência ao grupo. Você também pode incluir funções de agregação na Into cláusula para calcular valores para os elementos agrupados. Para obter uma lista de funções de agregação padrão, consulte Cláusula Aggregate.

Exemplo

O exemplo de código a seguir agrupa uma lista de clientes com base em sua localização (país/região) e fornece uma contagem dos clientes em cada grupo. Os resultados são ordenados pelo nome de país/região. Os resultados agrupados são ordenados pelo nome da cidade.

Public Sub GroupBySample()
    Dim customers = GetCustomerList()

    Dim customersByCountry = From cust In customers
                             Order By cust.City
                             Group By CountryName = cust.Country
                             Into RegionalCustomers = Group, Count()
                             Order By CountryName

    For Each country In customersByCountry
        Console.WriteLine(country.CountryName &
                          " (" & country.Count & ")" & vbCrLf)

        For Each customer In country.RegionalCustomers
            Console.WriteLine(vbTab & customer.CompanyName &
                              " (" & customer.City & ")")
        Next
    Next
End Sub

Consulte também