LinqDataSource.OrderGroupsBy Propriedade

Definição

Namespace:

System.Web.UI.WebControls

Assembly:

System.Web.Extensions.dll

Obtém ou define os campos que são usados para ordenar dados agrupados.

public:
 property System::String ^ OrderGroupsBy { System::String ^ get(); void set(System::String ^ value); };

public string OrderGroupsBy { get; set; }

member this.OrderGroupsBy : string with get, set

Public Property OrderGroupsBy As String

Valor da propriedade

String

Uma cadeia de caracteres usada para criar a cláusula Order Groups By.

Exemplos

O exemplo a seguir mostra como agrupar os dados usando duas propriedades e como classificar os dados agrupados usando uma dessas propriedades. Os dados de uma tabela nomeada Products são agrupados usando propriedades nomeadas CategoryID e Discontinued. Os dados agrupados são classificados pela CategoryID propriedade.

<asp:LinqDataSource 
   ContextTypeName="DataClassesDataContext" 
   TableName="Products" 
   GroupBy="new (CategoryID, Discontinued)" 
   OrderGroupsBy="Key.CategoryID"
   Select="new(Key.CategoryID, Key.Discontinued, Average(UnitPrice) As AvePrice)" 
   ID="LinqDataSource1" 
   runat="server" >
</asp:LinqDataSource>

<asp:LinqDataSource 
   ContextTypeName="DataClassesDataContext" 
   TableName="Products" 
   GroupBy="new (CategoryID, Discontinued)" 
   OrderGroupsBy="Key.CategoryID"
   Select="new(Key.CategoryID, Key.Discontinued, Average(UnitPrice) As AvePrice)" 
   ID="LinqDataSource1" 
   runat="server" >
</asp:LinqDataSource>

O exemplo a seguir mostra como agrupar os dados usando uma propriedade e como classificá-los com base nos resultados de uma função de agregação. Os dados da Products tabela são agrupados usando a CategoryID propriedade. Ele é classificado com base na média da UnitPrice propriedade dentro de cada grupo.

<asp:LinqDataSource 
   ContextTypeName="DataClassesDataContext" 
   TableName="Products" 
   GroupBy="CategoryID" 
   OrderGroupsBy="Average(UnitPrice)"
   Select="new(Key, Average(UnitPrice) As AvePrice)" 
   ID="LinqDataSource1" 
   runat="server" >
</asp:LinqDataSource>

<asp:LinqDataSource 
   ContextTypeName="DataClassesDataContext" 
   TableName="Products" 
   GroupBy="CategoryID" 
   OrderGroupsBy="Average(UnitPrice)"
   Select="new(Key, Average(UnitPrice) As AvePrice)" 
   ID="LinqDataSource1" 
   runat="server" >
</asp:LinqDataSource>

Comentários

Use a OrderGroupsBy propriedade para especificar como os grupos de dados são classificados. Por exemplo, você pode agrupar pela CategoryID propriedade e classificar cada grupo de IDs de categoria pela média da Price propriedade.

Você só pode definir a OrderGroupsBy propriedade quando agrupar os dados. Se você definir a OrderGroupsBy propriedade sem definir a GroupBy propriedade, o LinqDataSource controle gerará uma exceção.

A propriedade usada para classificar os dados deve ser uma propriedade usada para agrupar os dados ou o resultado de uma função de agregação nos dados agrupados. Para especificar como os dados são classificados, você pode adicionar um espaço e a cadeia de caracteres "Crescente", "ASC", "Decrescente" ou "DESC" a um nome de OrderGroupsBy propriedade na cadeia de caracteres.

Você pode especificar mais de uma propriedade na OrderGroupsBy propriedade. Separe cada propriedade usando uma vírgula.