ObjectDataSource.Select 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 ze základního úložiště dat voláním metody, která je identifikována SelectMethod vlastností s parametry v kolekci SelectParameters .
public:
System::Collections::IEnumerable ^ Select();public System.Collections.IEnumerable Select ();member this.Select : unit -> System.Collections.IEnumerablePublic Function Select () As IEnumerableNávraty
Seznam IEnumerable řádků dat.
Příklady
Příklad kódu najdete v tématu ObjectDataSource.
Poznámky
Zadaná metoda může mít jakýkoli podpis metody, ale musí vrátit nebo být odvozena z jednoho z typů uvedených v následující tabulce, ObjectDataSource aby ji ovládací prvek mohl úspěšně volat.
| Návratový typ | Akce |
|---|---|
| IEnumerable | Metoda IEnumerable vrátí metodu Select . |
| DataTable | Vytvoří DataView se pomocí DataTable a vrátí metodou Select . |
| DataView | Metoda DataView vrátí metodu Select . |
| DataSet | První DataTable z DataSet je extrahována a DataView je vytvořena a vrácena metodou Select . |
| Object | Objekt je zabalen do kolekce s jedním prvkem IEnumerable a vrácen metodou Select . |
Metoda identifikovaná SelectMethod vlastností může být metoda instance nebo static metoda (Shared v jazyce Visual Basic). Pokud se jedná o metodu instance, obchodní objekt je vytvořen a zničen při každém volání metody, která je určena SelectMethod vlastností, s výjimkou toho, že stejná instance se používá k volání metody, která je určena SelectMethod vlastností a metody, která je určena SelectCountMethod vlastností. Metoda Select vrátí IEnumerable rozhraní. Pokud ale chcete povolit scénáře ukládání do mezipaměti a filtrování, musí být vrácenou DataSet hodnotou objekt.
DataSet Zatímco třída neimplementuje IEnumerable rozhraní, ObjectDataSource ovládací prvek automaticky extrahuje výchozí DataView ovládací prvek, který implementuje IEnumerable.
Před provedením SelectOnSelecting operace je volána metoda pro vyvolání Selecting události. Událost můžete zpracovat Selecting , abyste prozkoumali hodnoty parametrů a provedli jakékoli předběžné zpracování před Select operací. K provedení operace ObjectDataSourceView načtení dat používá objekt reflexi k vytvoření instance objektu, který je identifikován TypeName vlastností . Potom zavolá metodu, která je identifikovaná SelectMethod vlastností, pomocí všech přidružených SelectParameters vlastností. Select Po dokončení OnSelected operace je volána metoda pro vyvolání Selected události. Událost můžete zpracovat, Selected abyste prozkoumali všechny návratové hodnoty, výstupní parametry a výjimky a provedli jakékoli následné zpracování.
SelectMethod Pokud vlastnost vrátí DataSetobjekt , DataTablenebo DataView a ukládání do mezipaměti je povoleno, ObjectDataSource načte data z mezipaměti a uloží je do mezipaměti během Select operace. Mezipaměť je vytvořena, zahozena nebo aktualizována na základě chování při ukládání do mezipaměti, které je určeno kombinací CacheDuration vlastností a CacheExpirationPolicy .
SelectMethod Pokud vlastnost vrátí DataSet objekt nebo DataTable a FilterExpression byla zadána vlastnost, vyhodnotí se se všemi zadanými FilterParameters vlastnostmi a výsledný filtr se použije na seznam dat během Select operace.
Metoda Select deleguje metodu SelectObjectDataSourceView , která je přidružena k ovládacímu ObjectDataSource prvku.
Další informace o slučování parametrů, životnosti objektu a řešení metod najdete v tématu SelectMethod.
ovládací prvky Data-Bound
ObjectDataSource Pokud je ovládací prvek přidružený k ovládacímu prvku vázanému na data, jako GridView je například ovládací prvek, není nutné volat metodu Select z kódu stránky. Metoda Select je vyvolána přímo ovládacím prvek vázaným na data.
