ObjectDataSource.Select Metoda

  • Reference

Definice

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

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.IEnumerable
Public Function Select () As IEnumerable

Návraty

IEnumerable

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.

Platí pro

Viz také