Sdílet prostřednictvím

ObjectDataSourceView.ExecuteSelect(DataSourceSelectArguments) Metoda

Definice

Obor názvů:
System.Web.UI.WebControls
Sestavení:
System.Web.dll

Načte data z objektu, který je identifikován vlastností TypeName voláním metody, která je identifikována SelectMethod vlastností a předání všech 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

Používá DataSourceSelectArguments se k vyžádání operací s daty nad rámec základního načtení dat.

Návraty

IEnumerable

Seznam IEnumerable řádků dat.

Výjimky

NotSupportedException

ExecuteSelect(DataSourceSelectArguments) Předání arguments metodě určuje, že zdroj dat by měl provést nějakou další práci při načítání dat, aby bylo možné stránkovat nebo řadit prostřednictvím načtených dat, ale ovládací prvek zdroje dat nepodporuje požadovanou funkci.

nebo

Objekt vrácený ExecuteSelect(DataSourceSelectArguments) metodou DataSet není nebo DataTablea ukládání do mezipaměti je povoleno. Pouze DataSet objekty a DataTable objekty lze pro ObjectDataSourceView ovládací prvek uložit do mezipaměti.

nebo

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

InvalidOperationException

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

nebo

Vlastnost je nastavena EnablePaging na true, ale StartRowIndexParameterName vlastnosti 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é na data nevolají metodu ExecuteSelect přímo. Místo toho použijte 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 Action
IEnumerable Metoda IEnumerable je vrácena Select .
DataTable Vytvoří se DataView pomocí DataTable metody a vrátí ji Select .
DataSet První DataTable z nich DataSet je extrahován a DataView je vytvořen a vrácen metodou Select .
Object Objekt je zabalený v jednom prvku IEnumerable a vrácen metodou Select .

Před provedením OnSelecting načtení dat se volá metoda pro vyvolání Selecting události. Tuto událost můžete zpracovat, abyste prozkoumali hodnoty parametrů a provedli jakékoli předběžné zpracování před operací.

Chcete-li provést operaci výběru, ObjectDataSourceView ovládací prvek používá reflexi k volání metody, která je identifikována SelectMethod vlastností a všechny přidružené parametry, které jsou v SelectParameters kolekci, a pak ji spustí. Po dokončení OnSelected operace se volá 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í při ukládání do mezipaměti určené kombinací CacheDuration vlastností a CacheExpirationPolicy vlastností.

Select Pokud metoda vrátí DataSet objekt a FilterExpression vlastnost byla zadána, je vyhodnocen 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í vybraného počtu řádků najdete v tématu Select.

Platí pro

Viz také