LinqDataSource.OrderGroupsBy Propriété

Définition

Espace de noms:

System.Web.UI.WebControls

Assembly:

System.Web.Extensions.dll

Obtient ou définit les champs utilisés pour trier des données groupées.

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

Valeur de propriété

String

Chaîne utilisée pour créer la clause Order Groups By.

Exemples

L’exemple suivant montre comment regrouper les données à l’aide de deux propriétés et comment trier les données groupées à l’aide de l’une de ces propriétés. Les données d’une table nommée Products sont regroupées à l’aide de propriétés nommées CategoryID et Discontinued. Les données groupées sont triées par la CategoryID propriété.

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

L’exemple suivant montre comment regrouper les données à l’aide d’une propriété et comment la trier en fonction des résultats d’une fonction d’agrégation. Les données de la Products table sont regroupées à l’aide de la CategoryID propriété. Elle est triée en fonction de la moyenne de la UnitPrice propriété au sein de chaque groupe.

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

Remarques

Vous utilisez la OrderGroupsBy propriété pour spécifier la façon dont les groupes de données sont triés. Par exemple, vous pouvez regrouper par la CategoryID propriété, puis trier chaque groupe d’ID de catégorie par la moyenne de la Price propriété.

Vous pouvez définir la OrderGroupsBy propriété uniquement lorsque vous avez regroupé les données. Si vous définissez la OrderGroupsBy propriété sans définir la GroupBy propriété, le LinqDataSource contrôle lève une exception.

La propriété utilisée pour trier les données doit être une propriété utilisée pour regrouper les données, ou le résultat d’une fonction d’agrégation sur les données groupées. Pour spécifier la façon dont les données sont triées, vous pouvez ajouter un espace et la chaîne « Croissant », « ASC », « Décroissant » ou « DESC » à un nom de propriété dans la OrderGroupsBy chaîne.

Vous pouvez spécifier plusieurs propriétés dans la OrderGroupsBy propriété. Séparez chaque propriété à l’aide d’une virgule.