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čítání dat. Tato třída se nemůže dě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 se sadou výsledků, jako je řazení dat nebo vrácení konkrétní podmnožiny dat. Tyto operace související s daty jsou výčtem vyčíslovány 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ému jsou přidruženy. Tímto způsobem ovládací prvek vázaný na data načte data z ovládacího prvku zdroje dat na vyžádání. Select(DataSourceSelectArguments, DataSourceViewSelectCallback) Vzhledem k tomu, že metoda přijímá DataSourceSelectArguments parametr, je ovládací prvek vázaný na data zodpovědný za vytvoření a správu objektu DataSourceSelectArguments a jeho předání metodě Select(DataSourceSelectArguments, DataSourceViewSelectCallback) při načítání dat z ovládacího prvku zdroje dat.

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

U seřazených sad výsledků kontrolují ovládací prvky vázané na data 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 vázaný na data požadovat seřazenou sadu výsledků z ovládacího prvku zdroje dat nastavením SortExpression vlastnosti objektu DataSourceSelectArguments předaného Select(DataSourceSelectArguments, DataSourceViewSelectCallback) metodě.

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 požadovat podmnožinu dat z ovládacího prvku zdroje dat pro stránkování nastavením StartRowIndex vlastností a MaximumRows objektu DataSourceSelectArguments předaného Select(DataSourceSelectArguments, DataSourceViewSelectCallback) metodě.

Pokud chcete načíst celkový počet řádků pro scénáře stránkování, 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žadovat celkový počet řádků z ovládacího prvku zdroje dat pro stránkování nastavením RetrieveTotalRowCount vlastnosti objektu DataSourceSelectArguments předaného Select(DataSourceSelectArguments, DataSourceViewSelectCallback) metodě . Když metoda Select(DataSourceSelectArguments, DataSourceViewSelectCallback) vrátí hodnotu , celkový počet řádků je obsažen ve TotalRowCount vlastnosti .

Důležité

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

Konstruktory

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)	Inicializuje novou instanci DataSourceSelectArguments třídy se zadaným výrazem řazení.
DataSourceSelectArguments(String, Int32, Int32)	Inicializuje novou instanci DataSourceSelectArguments třídy se zadaným výrazem řazení, počáteční pozicí a počtem řádků, které se mají vrátit pro scénáře stránkování.

Vlastnosti

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čtení 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 řazení dat načtených metodou Select(DataSourceSelectArguments, DataSourceViewSelectCallback) .
StartRowIndex	Získá nebo nastaví hodnotu, která představuje počáteční pozici ovládacího prvku zdroje dat by měl 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

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

Viz také

• DataSourceCapabilities