LinqDataSource.GroupByParameters Propriedade

Definição

Namespace:

System.Web.UI.WebControls

Assembly:

System.Web.Extensions.dll

Obtém a coleção de parâmetros usados para criar a cláusula 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

Valor da propriedade

ParameterCollection

Os parâmetros usados para criar a cláusula Group By.

Atributos

BrowsableAttribute PersistenceModeAttribute

Comentários

O LinqDataSource controle usa parâmetros na GroupByParameters coleção para criar a cláusula Group By em tempo de execução. Normalmente, você não usará a GroupByParameters coleção para agrupar dados. Em vez disso, você pode usar a GroupBy propriedade . Você usa a GroupByParameters coleção somente quando um valor na cláusula Group By deve ser definido em tempo de execução e esse valor não é um nome de propriedade. Por exemplo, use a GroupByParameters coleção para agrupar dados com base em se a LastName propriedade nos registros de dados é igual a um valor fornecido pelo usuário.

Se você quiser agrupar dados por uma propriedade e essa propriedade não precisar ser definida em tempo de execução, você poderá definir a propriedade de agrupamento na GroupBy propriedade . Por exemplo, para retornar valores de uma tabela de banco de dados agrupada por LastName, defina GroupBy como "LastName" sem parâmetros. Se você quiser agrupar dados dinamicamente por uma propriedade, crie um manipulador de eventos para o Selecting evento e personalize a GroupBy propriedade conforme necessário.

Você não pode atribuir o nome de uma propriedade como o valor de um parâmetro na GroupByParameters coleção. Você adiciona parâmetros à GroupByParameters coleção quando deseja adicionar uma condição à GroupBy propriedade que deve ser definida em tempo de execução.

Para definir valores na GroupByParameters coleção, você atribui um nome a cada parâmetro e, em seguida, adiciona um espaço reservado na GroupBy propriedade para esse parâmetro nomeado. Na cláusula Agrupar Por, preceda cada nome de parâmetro com o símbolo @.