LinqDataSource.OrderGroupsBy プロパティ

定義

名前空間:

System.Web.UI.WebControls

アセンブリ:

System.Web.Extensions.dll

グループ化されたデータの並べ替えに使用するフィールドを取得または設定します。

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

プロパティ値

String

Order Groups By 句の作成に使用される文字列。

例

次の例は、2 つのプロパティを使用してデータをグループ化する方法と、それらのプロパティのいずれかを使用してグループ化されたデータを並べ替える方法を示しています。 名前付きのテーブルのデータは、名前付きProducts``CategoryIDプロパティと Discontinued. グループ化されたデータは、プロパティによって CategoryID 並べ替えられます。

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

次の例は、プロパティを使用してデータをグループ化する方法と、集計関数の結果に基づいてデータを並べ替える方法を示しています。 テーブルの Products データは、プロパティを使用して CategoryID グループ化されます。 各グループ内のプロパティの平均に UnitPrice 基づいて並べ替えられます。

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

注釈

このプロパティを OrderGroupsBy 使用して、データグループの並べ替え方法を指定します。 たとえば、プロパティでグループ化 CategoryID し、各カテゴリ ID グループをプロパティの Price 平均で並べ替えることができます。

このプロパティは、データを OrderGroupsBy グループ化した場合にのみ設定できます。 プロパティを設定せずにプロパティをOrderGroupsByGroupBy設定すると、コントロールはLinqDataSource例外をスローします。

データの並べ替えに使用するプロパティは、データのグループ化に使用されるプロパティか、グループ化されたデータに対する集計関数の結果である必要があります。 データの並べ替え方法を指定するには、文字列内のプロパティ名にスペースと文字列 "Ascending"、"ASC"、"Descending"、または "DESC" を OrderGroupsBy 追加します。

プロパティには複数のプロパティを OrderGroupsBy 指定できます。 コンマを使用して各プロパティを区切ります。