ObjectDataSourceView.ExecuteSelect(DataSourceSelectArguments) Metoda

Definice

Obor názvů:

System.Web.UI.WebControls

Sestavení:

System.Web.dll

Načte data z objektu identifikovaného TypeName vlastností voláním metody, která je identifikovaná SelectMethod vlastností a předáním hodnot v kolekci SelectParameters .

protected public:
 override System::Collections::IEnumerable ^ ExecuteSelect(System::Web::UI::DataSourceSelectArguments ^ arguments);

protected internal override System.Collections.IEnumerable ExecuteSelect (System.Web.UI.DataSourceSelectArguments arguments);

override this.ExecuteSelect : System.Web.UI.DataSourceSelectArguments -> System.Collections.IEnumerable

Protected Friend Overrides Function ExecuteSelect (arguments As DataSourceSelectArguments) As IEnumerable

Parametry

arguments

DataSourceSelectArguments

Slouží DataSourceSelectArguments k vyžádání operací s daty nad rámec základního načítání dat.

Návraty

IEnumerable

Seznam IEnumerable řádků dat.

Výjimky

NotSupportedException

Metoda předaná argumentsExecuteSelect(DataSourceSelectArguments) metodě určuje, že zdroj dat by měl při načítání dat provádět další práci, aby bylo možné provádět stránkování nebo řazení načtených dat, ale ovládací prvek zdroje dat nepodporuje požadovanou funkci.

-nebo-

Objekt vrácený metodou ExecuteSelect(DataSourceSelectArguments) není DataSet nebo DataTablea ukládání do mezipaměti je povoleno. Do mezipaměti ObjectDataSourceView ovládacího prvku lze ukládat pouze DataSet objekty aDataTable.

-nebo-

Ukládání do mezipaměti i zosobnění klienta je povolené. Nástroj ObjectDataSource nepodporuje ukládání do mezipaměti, pokud je povolené zosobnění klienta.

InvalidOperationException

Objekt vrácený ExecuteSelect(DataSourceSelectArguments) metodou je , DataSetale ve své Tables kolekci nemá žádné tabulky.

-nebo-

Vlastnost EnablePaging je nastavena na true, ale StartRowIndexParameterName vlastnosti a MaximumRowsParameterName nejsou nastaveny.

Poznámky

Třída ObjectDataSourceView implementuje zděděnou ExecuteSelect metodu pro načtení dat pomocí obchodního objektu. Vývojáři stránek a autoři ovládacích prvků vázaných na data nevolají metodu ExecuteSelect přímo, ale používají veřejně vystavenou Select metodu.

Zadaná metoda může mít libovolný podpis metody, ale musí vrátit jeden z typů pro ObjectDataSource ovládací prvek, které jsou uvedeny v následující tabulce, aby bylo možné ji úspěšně volat.

Návratový typ	Akce
IEnumerable	Metoda IEnumerable vrátí Select parametr .
DataTable	Vytvoří DataView se pomocí DataTable metody a vrátí ji Select metoda.
DataSet	První DataTable z DataSet je extrahován a DataView je vytvořen a vrácen metodou Select .
Object	Objekt je zabalen do jednoho prvku IEnumerable a vrácen metodou Select .

Před načtením dat je OnSelecting volána metoda pro vyvolání Selecting události. Tuto událost můžete zpracovat k prozkoumání hodnot parametrů a provedení předběžného zpracování před operací.

K provedení operace ObjectDataSourceView výběru ovládací prvek pomocí reflexe zavolá metodu, která je identifikována vlastností a všemi přidruženými SelectMethod parametry, které jsou v kolekci SelectParameters , a pak ji spustí. Po dokončení OnSelected operace je volána metoda pro vyvolání Selected události. Tuto událost můžete zpracovat, abyste prozkoumali všechny návratové hodnoty a kódy chyb a provedli jakékoli následné zpracování.

Select Pokud metoda vrátí DataSet objekt a ukládání do mezipaměti je povoleno, ObjectDataSourceView načte data z a uloží data do mezipaměti během operace. Mezipaměť se vytvoří, zahodí nebo aktualizuje na základě chování ukládání do mezipaměti, které je určeno kombinací CacheDuration vlastností a CacheExpirationPolicy .

Select Pokud metoda vrátí DataSet objekt a FilterExpression byla zadána vlastnost, vyhodnotí se spolu se všemi zadanými FilterParameters vlastnostmi a výsledný filtr se použije na seznam dat během Select operace.

Informace o vrácení počtu vybraných řádků najdete v tématu Select.

Viz také

• Select(DataSourceSelectArguments)
• SelectMethod
• SelectCountMethod
• OnSelecting(ObjectDataSourceSelectingEventArgs)
• OnSelected(ObjectDataSourceStatusEventArgs)
• Selecting
• Selected