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 z podkladové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 odvozen z jednoho z typů uvedených v následující tabulce, ObjectDataSource aby ovládací prvek mohl úspěšně volat.
| Návratový typ | Action |
|---|---|
| IEnumerable | Metoda IEnumerable je vrácena Select . |
| DataTable | A DataView se vytvoří pomocí DataTable metody a vrácena metodou Select . |
| DataView | Metoda DataView je vrácena 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 kolekci s jedním prvkem IEnumerable a vrácen metodou Select . |
Metoda, která je identifikována SelectMethod vlastností může být instance metoda nebo static (Shared v jazyce Visual Basic). Pokud se jedná o metodu instance, obchodní objekt je vytvořen a zničen pokaždé, když je volána metoda, která je určena SelectMethod vlastností, s výjimkou, že stejná instance se používá k volání metody, která je určena SelectMethod vlastností a metoda, 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 návratová hodnota objektem DataSet .
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 se volá 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í. Chcete-li provést operaci načítání dat, ObjectDataSourceView objekt používá reflexi k vytvoření instance objektu, který je identifikován vlastností TypeName . Potom volá metodu, která je identifikována SelectMethod vlastností, pomocí všech přidružených SelectParameters vlastností. Select Po dokončení OnSelected operace se volá metoda pro vyvolání Selected události. Událost můžete zpracovat Selected , abyste prozkoumali všechny vrácené hodnoty, výstupní parametry a výjimky a provedli jakékoli následné zpracování.
SelectMethod Pokud vlastnost vrátí DataSethodnotu , DataTablenebo DataView objekt a ukládání do mezipaměti je povoleno, ObjectDataSource načte data z a uloží data do mezipaměti během Select 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í.
SelectMethod Pokud vlastnost vrátí DataSet nebo DataTable objekt a FilterExpression vlastnost byla zadána, je vyhodnocena s libovolnými zadanými FilterParameters vlastnostmi a výsledný filtr se použije na seznam dat během Select operace.
Metoda Select deleguje na 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 naleznete 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 prvku vázaném na data.
