LinqDataSource.GroupByParameters Eigenschaft

Definition

Ruft die Auflistung der zum Erstellen der Group By-Klausel verwendeten Parameter ab.

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

Eigenschaftswert

Die Parameter, die zum Erstellen der Group By-Klausel verwendet werden.

Attribute

Hinweise

Das LinqDataSource Steuerelement verwendet Parameter in der GroupByParameters Auflistung, um die Group By-Klausel zur Laufzeit zu erstellen. In der Regel verwenden Sie die GroupByParameters Sammlung nicht zum Gruppieren von Daten. Stattdessen können Sie die GroupBy -Eigenschaft verwenden. Sie verwenden die GroupByParameters Auflistung nur, wenn zur Laufzeit ein Wert in der Group By-Klausel festgelegt werden muss und dieser Wert kein Eigenschaftsname ist. Verwenden Sie beispielsweise die GroupByParameters Auflistung, um Daten basierend darauf zu gruppieren, ob die LastName Eigenschaft in den Datensätzen einem vom Benutzer bereitgestellten Wert entspricht.

Wenn Sie Daten nach einer Eigenschaft gruppieren möchten und diese Eigenschaft nicht zur Laufzeit festgelegt werden muss, können Sie die Gruppierungseigenschaft in der GroupBy -Eigenschaft definieren. Wenn Sie z. B. Werte aus einer Datenbanktabelle zurückgeben möchten, die nach gruppiert ist LastName, legen Sie ohne Parameter auf "LastName" fest GroupBy . Wenn Sie Daten dynamisch nach einer Eigenschaft gruppieren möchten, erstellen Sie einen Ereignishandler für das Selecting Ereignis, und passen Sie die GroupBy Eigenschaft nach Bedarf an.

Sie können den Namen einer Eigenschaft nicht als Wert für einen Parameter in der GroupByParameters Auflistung zuweisen. Sie fügen der GroupByParameters Auflistung Parameter hinzu, wenn Sie der Eigenschaft eine Bedingung hinzufügen möchten, die GroupBy zur Laufzeit festgelegt werden muss.

Um Werte in der GroupByParameters Auflistung festzulegen, weisen Sie jedem Parameter einen Namen zu und fügen dann in der -Eigenschaft einen Platzhalter für diesen GroupBy benannten Parameter hinzu. Stellen Sie in der Group By-Klausel jedem Parameternamen das @-Symbol voran.

Gilt für: