ObjectDataSourceView.ExecuteSelect(DataSourceSelectArguments) Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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.IEnumerableProtected Friend Overrides Function ExecuteSelect (arguments As DataSourceSelectArguments) As IEnumerableParametry
- arguments
- DataSourceSelectArguments
Slouží DataSourceSelectArguments k vyžádání operací s daty nad rámec základního načítání dat.
Návraty
Seznam IEnumerable řádků dat.
Výjimky
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.
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.
