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 子句的字串。

範例

下列範例示範如何使用兩個屬性來分組資料，以及如何使用其中一個屬性來排序分組的資料。 名為 的資料表 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 屬性分組，然後依屬性的平均值排序每個類別識別碼 Price 群組。

只有在您已將資料分組時，才可以設定 OrderGroupsBy 屬性。 如果您未設定 GroupBy 屬性來 OrderGroupsBy 設定 屬性，控制項會 LinqDataSource 擲回例外狀況。

用來排序資料的屬性必須是用來分組資料的屬性，或是群組資料上匯總函數的結果。 若要指定資料排序方式，您可以將空格和字串 「Ascending」、「ASC」、「Descending」 或 「DESC」 新增至字串中的 OrderGroupsBy 屬性名稱。

您可以在 屬性中 OrderGroupsBy 指定多個屬性。 使用逗號分隔每個屬性。