LinqDataSource.GroupByParameters Właściwość

Definicja

Pobiera kolekcję parametrów używanych do tworzenia klauzuli Grupuj według.

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

Wartość właściwości

Parametry używane do tworzenia klauzuli Group By.

Atrybuty

Uwagi

Kontrolka LinqDataSource używa parametrów w GroupByParameters kolekcji do utworzenia klauzuli Group By w czasie wykonywania. Zazwyczaj kolekcja nie jest używana GroupByParameters do grupowania danych. Zamiast tego można użyć GroupBy właściwości . Kolekcja jest używana GroupByParameters tylko wtedy, gdy wartość w klauzuli Grupuj według musi być ustawiona w czasie wykonywania i ta wartość nie jest nazwą właściwości. Na przykład użyj kolekcji GroupByParameters , aby pogrupować dane na podstawie tego, czy LastName właściwość w rekordach danych jest równa wartości podanej przez użytkownika.

Jeśli chcesz grupować dane według właściwości i ta właściwość nie musi być ustawiana w czasie wykonywania, możesz zdefiniować właściwość grupowania we GroupBy właściwości . Na przykład, aby zwrócić wartości z tabeli bazy danych pogrupowane według LastName, ustaw na GroupBy wartość "LastName" bez żadnych parametrów. Jeśli chcesz dynamicznie grupować dane według właściwości, utwórz procedurę obsługi zdarzeń dla Selecting zdarzenia i dostosuj właściwość zgodnie z GroupBy potrzebami.

Nie można przypisać nazwy właściwości jako wartości parametru w kolekcji GroupByParameters . Parametry są dodawane do GroupByParameters kolekcji, gdy chcesz dodać warunek do GroupBy właściwości, która musi być ustawiona w czasie wykonywania.

Aby ustawić wartości w GroupByParameters kolekcji, należy przypisać nazwę do każdego parametru, a następnie dodać symbol zastępczy we GroupBy właściwości dla tego nazwanego parametru. W klauzuli Grupuj według należy poprzedać każdą nazwę parametru symbolem @.

Dotyczy