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. Например, можно использовать коллекцию GroupByParameters для группирования данных на основе того, что свойство LastName в записях данных равно значению, предоставленному пользователем.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. Параметры добавляются в коллекцию GroupByParameters, если необходимо добавить условие в свойство GroupBy, которое должно быть задано во время выполнения.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.

Применяется к