LinqDataSource.GroupByParameters プロパティ

定義

Group By 句の作成に使用されるパラメーターのコレクションを取得します。Gets the collection of parameters that are used to create the Group By clause.

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; }
member this.GroupByParameters : System.Web.UI.WebControls.ParameterCollection
Public ReadOnly Property GroupByParameters As ParameterCollection

プロパティ値

Group By 句の作成に使用されるパラメーター。The parameters that are used to create the Group By clause.

属性

注釈

LinqDataSource コントロールは、GroupByParameters コレクションのパラメーターを使用して、実行時に Group By 句を作成します。The LinqDataSource control uses parameters in the GroupByParameters collection to create the Group By clause at run time. 通常は、GroupByParameters コレクションを使用してデータをグループ化しません。Typically you will not use the GroupByParameters collection to group data. 代わりに、GroupBy プロパティを使用できます。Instead, you can use the GroupBy property. GroupByParameters コレクションは、Group By 句の値を実行時に設定する必要があり、その値がプロパティ名ではない場合にのみ使用します。You use the GroupByParameters collection only when a value in the Group By clause must be set at run time and that value is not a property name. たとえば、データレコードの LastName プロパティがユーザーによって指定された値と等しいかどうかに基づいてデータをグループ化するには、GroupByParameters コレクションを使用します。For example, use the GroupByParameters collection to group data based on whether the LastName property in the data records equals a value provided by the user.

プロパティでデータをグループ化する必要があり、そのプロパティを実行時に設定する必要がない場合は、GroupBy プロパティでグループ化プロパティを定義できます。If you want to group data by a property and that property does not have to be set at run time, you can define the grouping property in the GroupBy property. たとえば、LastName別にグループ化されたデータベーステーブルから値を返すには、パラメーターを指定せずに GroupBy を "LastName" に設定します。For example, to return values from a database table grouped by LastName, set GroupBy to "LastName" without any parameters. プロパティによってデータを動的にグループ化する場合は、Selecting イベントのイベントハンドラーを作成し、必要に応じて GroupBy プロパティをカスタマイズします。If you want to dynamically group data by a property, create an event handler for the Selecting event and customize the GroupBy property as needed.

GroupByParameters コレクションのパラメーターの値として、プロパティの名前を割り当てることはできません。You cannot assign the name of a property as the value for a parameter in the GroupByParameters collection. 実行時に設定する必要がある条件を GroupBy プロパティに追加する場合は、GroupByParameters コレクションにパラメーターを追加します。You add parameters to the GroupByParameters collection when you want to add a condition to the GroupBy property that must be set at run time.

GroupByParameters コレクションに値を設定するには、各パラメーターに名前を割り当ててから、その名前付きパラメーターの GroupBy プロパティにプレースホルダーを追加します。To set values in the GroupByParameters collection, you assign a name to each parameter and then add a placeholder in the GroupBy property for that named parameter. Group By 句で、各パラメーター名の先頭に @ 記号を付けます。In the Group By clause, preface each parameter name with the @ symbol.

適用対象