Partager via


LinqDataSource.GroupByParameters Propriété

Définition

Obtient la collection de paramètres utilisés pour créer la clause 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

Valeur de propriété

Paramètres utilisés pour créer la clause Group By.

Attributs

Remarques

Le LinqDataSource contrôle utilise des paramètres dans la GroupByParameters collection pour créer la clause Group By au moment de l’exécution. En règle générale, vous n’utiliserez pas la GroupByParameters collection pour regrouper des données. Au lieu de cela, vous pouvez utiliser la GroupBy propriété . Vous utilisez la GroupByParameters collection uniquement lorsqu’une valeur dans la clause Group By doit être définie au moment de l’exécution et que cette valeur n’est pas un nom de propriété. Par exemple, utilisez la GroupByParameters collection pour regrouper des données selon que la LastName propriété dans les enregistrements de données correspond à une valeur fournie par l’utilisateur.

Si vous souhaitez regrouper des données par une propriété et que cette propriété n’a pas besoin d’être définie au moment de l’exécution, vous pouvez définir la propriété de regroupement dans la GroupBy propriété . Par exemple, pour retourner des valeurs d’une table de base de données groupée par LastName, définissez GroupBy sur « LastName » sans aucun paramètre. Si vous souhaitez regrouper dynamiquement des données par une propriété, créez un gestionnaire d’événements pour l’événement Selecting et personnalisez la GroupBy propriété en fonction des besoins.

Vous ne pouvez pas attribuer le nom d’une propriété comme valeur pour un paramètre dans la GroupByParameters collection. Vous ajoutez des paramètres à la GroupByParameters collection lorsque vous souhaitez ajouter une condition à la GroupBy propriété qui doit être définie au moment de l’exécution.

Pour définir des valeurs dans la GroupByParameters collection, vous attribuez un nom à chaque paramètre, puis ajoutez un espace réservé dans la GroupBy propriété pour ce paramètre nommé. Dans la clause Group By, préfacez chaque nom de paramètre avec le symbole @.

S’applique à