LinqDataSource.OrderGroupsBy Propriedade

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 de Propriedade

Uma cadeia que é usada para criar a cláusula Order Groups By.

Exemplos

O exemplo seguinte mostra como agrupar os dados usando duas propriedades e como ordenar 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 ordenados 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 seguinte mostra como agrupar os dados usando uma propriedade e como ordená-los com base nos resultados de uma função de agregação. Os dados da Products tabela são agrupados usando a CategoryID propriedade. É ordenado com base na média das UnitPrice propriedades 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>

Observações

Usas a OrderGroupsBy propriedade para especificar como os grupos de dados estão organizados. Por exemplo, pode agrupar pela CategoryID propriedade e depois ordenar cada grupo de identificação de categoria pela média da Price propriedade.

Só pode definir a OrderGroupsBy propriedade quando tiver agrupado os dados. Se definires a OrderGroupsBy propriedade sem a GroupBy definir, o LinqDataSource controlo lança uma exceção.

A propriedade usada para ordenar os dados deve ser ou uma propriedade usada para agrupar os dados, ou o resultado de uma função de agregação sobre os dados agrupados. Para especificar como os dados estão organizados, pode adicionar um espaço e a cadeia "Ascendente", "ASC", "Descendente" ou "DESC" a um nome de propriedade na OrderGroupsBy cadeia.

Pode especificar mais do que uma propriedade dentro da OrderGroupsBy propriedade. Separa cada propriedade usando uma vírgula.