ObjectQuery<T>.GroupBy(String, String, ObjectParameter[]) Método

Definição

Espaço de Nomes:
System.Data.Objects
Assemblagem:
System.Data.Entity.dll

Agrupa os resultados da consulta pelos critérios especificados.

public:
 System::Data::Objects::ObjectQuery<System::Data::Common::DbDataRecord ^> ^ GroupBy(System::String ^ keys, System::String ^ projection, ... cli::array <System::Data::Objects::ObjectParameter ^> ^ parameters);
public System.Data.Objects.ObjectQuery<System.Data.Common.DbDataRecord> GroupBy(string keys, string projection, params System.Data.Objects.ObjectParameter[] parameters);
member this.GroupBy : string * string * System.Data.Objects.ObjectParameter[] -> System.Data.Objects.ObjectQuery<System.Data.Common.DbDataRecord>
Public Function GroupBy (keys As String, projection As String, ParamArray parameters As ObjectParameter()) As ObjectQuery(Of DbDataRecord)

Parâmetros

keys
String

As colunas-chave pelas quais agrupar os resultados.

projection
String

A lista de propriedades selecionadas que define a projeção.

parameters
ObjectParameter[]

Zero ou mais parâmetros usados neste método.

Devoluções

ObjectQuery<DbDataRecord>

Uma nova ObjectQuery<T> instância de tipo DbDataRecord equivalente à instância original com GROUP BY aplicado.

Exceções

ArgumentNullException

O keys parâmetro é null ou uma cadeia vazia.

-ou-

O projection parâmetro é null ou uma cadeia vazia.

Exemplos

Este exemplo cria um novo ObjectQuery<T> objeto que contém os resultados da consulta existente agrupados por nome do produto.

    using (AdventureWorksEntities context =
        new AdventureWorksEntities())
    {
        string queryString = @"SELECT VALUE product
            FROM AdventureWorksEntities.Products AS product";

        ObjectQuery<Product> productQuery =
            new ObjectQuery<Product>(queryString,
                context, MergeOption.NoTracking);

        ObjectQuery<DbDataRecord> productQuery2 =
            productQuery.GroupBy("it.name AS pn",
            "Sqlserver.COUNT(it.Name) as count, pn");

        // Iterate through the collection of Products
        // after the GroupBy method was called.
        foreach (DbDataRecord result in productQuery2)
        {
            Console.WriteLine("Name: {0}; Count: {1}",
                result["pn"], result["count"]);
        }
    }
}

Este exemplo devolve um conjunto de registos de dados aninhados que contêm a Contact.LastName coluna, agrupada e ordenada alfabeticamente pela primeira letra de Contact.LastName.

using (AdventureWorksEntities context =
    new AdventureWorksEntities())
{
    // Define the query with a GROUP BY clause that returns
    // a set of nested LastName records grouped by first letter.
    ObjectQuery<DbDataRecord> query =
        context.Contacts
        .GroupBy("SUBSTRING(it.LastName, 1, 1) AS ln", "ln")
        .Select("it.ln AS ln, (SELECT c1.LastName " +
        "FROM AdventureWorksEntities.Contacts AS c1 " +
        "WHERE SubString(c1.LastName, 1, 1) = it.ln) AS CONTACT")
        .OrderBy("it.ln");

    // Execute the query and walk through the nested records.
    foreach (DbDataRecord rec in
        query.Execute(MergeOption.AppendOnly))
    {
        Console.WriteLine("Last names that start with the letter '{0}':",
                    rec[0]);
        List<DbDataRecord> list = rec[1] as List<DbDataRecord>;
        foreach (DbDataRecord r in list)
        {
            for (int i = 0; i < r.FieldCount; i++)
            {
                Console.WriteLine("   {0} ", r[i]);
            }
        }
    }
}

Observações

GroupBy aplica a projeção especificada pelo projection parâmetro. Isto significa que o ObjectQuery<T> devolvido pelo GroupBy método é sempre do tipo DbDataRecord. Para obter mais informações, consulte Consultas de Objetos.

Aplica-se a

Ver também