DataSourceSelectArguments Třída

Definice

Obor názvů:

System.Web.UI

Sestavení:

System.Web.dll

Poskytuje mechanismus, který ovládací prvky vázané na data používají k vyžádání operací souvisejících s daty z ovládacích prvků zdroje dat při načtení dat. Tuto třídu nelze zdědit.

public ref class DataSourceSelectArguments sealed

public sealed class DataSourceSelectArguments

type DataSourceSelectArguments = class

Public NotInheritable Class DataSourceSelectArguments

Dědičnost

Object

DataSourceSelectArguments

Poznámky

Ovládací prvky vázané na data používají DataSourceSelectArguments třídu k vyžádání, aby ovládací prvek zdroje dat prováděl další operace související s daty v sadě výsledků, jako je řazení dat nebo vrácení určité podmnožiny dat. Tyto operace související s daty jsou výčtem výčtu DataSourceCapabilities . Následující tabulka uvádí, jak DataSourceSelectArguments třída podporuje tyto operace související s daty.

Schopnost	Související vlastnosti DataSourceSelectArguments
DataSourceCapabilities.Sort	SortExpression
DataSourceCapabilities.Page	StartRowIndex, MaximumRows
DataSourceCapabilities.RetrieveTotalRowCount	RetrieveTotalRowCount, TotalRowCount

Ovládací prvky vázané na data explicitně volají metodu PerformSelect pro vytvoření vazby dat, která volá Select(DataSourceSelectArguments, DataSourceViewSelectCallback) metodu ovládacího prvku zdroje dat, ke kterým jsou přidruženy. Tímto způsobem ovládací prvek vázaný na data načítá data ze správy zdrojů dat na vyžádání. Vzhledem k tomu, že Select(DataSourceSelectArguments, DataSourceViewSelectCallback) metoda přijímá DataSourceSelectArguments parametr, je ovládací prvek svázaný s daty zodpovědný za vytvoření a správu objektu DataSourceSelectArguments a jeho předání Select(DataSourceSelectArguments, DataSourceViewSelectCallback) metodě při načítání dat ze správy zdroje dat.

V některých případech nemusí ovládací prvky vázané na data potřebovat žádné další možnosti související s daty. V tomto případě ovládací prvky vázané na data předávají Empty objekt argumentů metodě Select(DataSourceSelectArguments, DataSourceViewSelectCallback) .

U seřazených sad výsledků ovládací prvky vázané na data kontrolují vlastnost zobrazení CanSort zdroje dat za běhu a přidávají DataSourceCapabilities.Sort funkci pomocí AddSupportedCapabilities(DataSourceCapabilities) metody. Jako samostatnou operaci může ovládací prvek svázaný s daty požádat o seřazenou sadu výsledků z ovládacího prvku zdroje dat nastavením SortExpression vlastnosti objektu DataSourceSelectArguments předaného metodě Select(DataSourceSelectArguments, DataSourceViewSelectCallback) .

Ve scénářích stránkování ovládací prvky vázané na data kontrolují vlastnost zobrazení CanPage zdroje dat za běhu a přidávají DataSourceCapabilities.Page funkci pomocí AddSupportedCapabilities(DataSourceCapabilities) metody. Jako samostatnou operaci může ovládací prvek vázaný na data vyžádat podmnožinu dat z ovládacího prvku zdroje dat pro stránkování nastavením StartRowIndex a MaximumRows vlastností objektu DataSourceSelectArguments předaného metodě Select(DataSourceSelectArguments, DataSourceViewSelectCallback) .

Pokud chcete načíst celkový počet řádků pro stránkovací scénáře, ovládací prvky vázané na data kontrolují vlastnost zobrazení CanRetrieveTotalRowCount zdroje dat za běhu a přidávají DataSourceCapabilities.RetrieveTotalRowCount funkci pomocí AddSupportedCapabilities(DataSourceCapabilities) metody. Jako samostatnou operaci může ovládací prvek vázané na data požádat o celkový počet řádků z ovládacího prvku zdroje dat pro stránkování nastavením RetrieveTotalRowCount vlastnosti objektu DataSourceSelectArguments předaného metodě Select(DataSourceSelectArguments, DataSourceViewSelectCallback) . Když metoda Select(DataSourceSelectArguments, DataSourceViewSelectCallback) vrátí, celkový počet řádků je obsažen v TotalRowCount vlastnosti.

Důležité

Pokud je některá z DataSourceSelectArguments vlastností nastavena, ale aktuálně vázané řízení zdroje dat nepodporuje požadovanou schopnost, InvalidOperationException vyvolá se výjimka při DataSourceSelectArguments.RaiseUnsupportedCapabilitiesError(DataSourceView) zavolání metody.

Konstruktory

Name	Description
DataSourceSelectArguments()	Inicializuje novou výchozí instanci DataSourceSelectArguments třídy.
DataSourceSelectArguments(Int32, Int32)	Inicializuje novou instanci DataSourceSelectArguments třídy se zadanou počáteční pozicí a počtem řádků, které se mají vrátit pro scénáře stránkování.
DataSourceSelectArguments(String, Int32, Int32)	Inicializuje novou instanci třídy pomocí zadaného výrazu DataSourceSelectArguments řazení, počáteční pozice a počtu řádků, které se mají vrátit pro scénáře stránkování.
DataSourceSelectArguments(String)	Inicializuje novou instanci DataSourceSelectArguments třídy se zadaným výrazem řazení.

Vlastnosti

Name	Description
Empty	DataSourceSelectArguments Získá objekt s výrazem řazení nastaveným na Empty.
MaximumRows	Získá nebo nastaví hodnotu, která představuje maximální počet řádků dat, které ovládací prvek zdroje dat vrátí pro operaci načítání dat.
RetrieveTotalRowCount	Získá nebo nastaví hodnotu určující, zda má ovládací prvek zdroje dat načíst počet všech řádků dat během operace načítání dat.
SortExpression	Získá nebo nastaví výraz, který zobrazení zdroje dat používá k seřazení dat načtených metodou Select(DataSourceSelectArguments, DataSourceViewSelectCallback) .
StartRowIndex	Získá nebo nastaví hodnotu, která představuje počáteční pozici, kterou má ovládací prvek zdroje dat použít při načítání řádků dat během operace načítání dat.
TotalRowCount	Získá nebo nastaví počet řádků načtených během operace načítání dat.

Metody

Name	Description
AddSupportedCapabilities(DataSourceCapabilities)	Přidá do DataSourceSelectArguments instance jednu funkci, která se používá k porovnání podporovaných funkcí a požadovaných možností.
Equals(Object)	Určuje, zda je zadaná DataSourceSelectArguments instance rovna aktuální instanci.
GetHashCode()	Vrátí kód hash pro DataSourceSelectArguments typ.
GetType()	Získá Type aktuální instance. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
RaiseUnsupportedCapabilitiesError(DataSourceView)	Porovná možnosti požadované pro ExecuteSelect(DataSourceSelectArguments) operaci s možnostmi, které podporuje zobrazení zadaného zdroje dat.
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Viz také

• DataSourceCapabilities