LinqDataSource.GroupByParameters 屬性

定義

命名空間:

System.Web.UI.WebControls

組件:

System.Web.Extensions.dll

取得用於建立 Group By 子句的參數集合。

public:
 property System::Web::UI::WebControls::ParameterCollection ^ GroupByParameters { System::Web::UI::WebControls::ParameterCollection ^ get(); };

[System.ComponentModel.Browsable(false)]
[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)]
public System.Web.UI.WebControls.ParameterCollection GroupByParameters { get; }

[<System.ComponentModel.Browsable(false)>]
[<System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)>]
member this.GroupByParameters : System.Web.UI.WebControls.ParameterCollection

Public ReadOnly Property GroupByParameters As ParameterCollection

屬性值

ParameterCollection

用來建立 Group By 子句的參數。

屬性

BrowsableAttribute PersistenceModeAttribute

備註

控制項 LinqDataSource 會使用集合中的 GroupByParameters 參數，在執行時間建立 Group By 子句。 您通常不會使用 GroupByParameters 集合來分組資料。 相反地，您可以使用 GroupBy 屬性。 只有當必須在執行時間設定 Group By 子句中的值，且該值不是屬性名稱時，才使用 GroupByParameters 集合。 例如，使用 GroupByParameters 集合根據資料記錄中的 屬性是否 LastName 等於使用者所提供的值來分組資料。

如果您想要依屬性將資料分組，而且該屬性不需要在執行時間設定，您可以在 屬性中 GroupBy 定義群組屬性。 例如，若要從分組 LastName 的資料庫資料表傳回值，請將 設定 GroupBy 為 「LastName」，而不需任何參數。 如果您想要依屬性動態分組資料，請建立 Selecting 事件的事件處理常式，並視需要自訂 GroupBy 屬性。

您無法將屬性的名稱指派為集合中 GroupByParameters 參數的值。 當您想要將條件加入至必須在執行時間設定的屬性時，請將參數新增至 GroupByParametersGroupBy 集合。

若要設定集合中的 GroupByParameters 值，您可以將名稱指派給每個參數，然後在該具名參數的 GroupBy 屬性中新增預留位置。 在 Group By 子句中，在每個參數名稱前面加上 @ 符號。