ObjectDataSource.Select Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Web.UI.WebControls

Zestaw:: System.Web.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Pobiera dane z bazowego magazynu danych, wywołując metodę, która jest identyfikowana przez SelectMethod właściwość z parametrami w kolekcji SelectParameters .

public:
 System::Collections::IEnumerable ^ Select();

public System.Collections.IEnumerable Select ();

member this.Select : unit -> System.Collections.IEnumerable

Public Function Select () As IEnumerable

Zwraca

IEnumerable

Lista IEnumerable wierszy danych.

Przykłady

Aby zapoznać się z przykładem kodu, zobacz ObjectDataSource.

Uwagi

Określona metoda może mieć dowolny podpis metody, ale musi zwrócić lub pochodzić z jednego z typów wymienionych w poniższej tabeli, aby kontrolka ObjectDataSource mogła ją wywołać pomyślnie.

Typ zwracany	Akcja
IEnumerable	Element IEnumerable jest zwracany przez metodę Select .
DataTable	Element A DataView jest tworzony przy użyciu DataTable metody i zwracanej przez metodę Select .
DataView	Element DataView jest zwracany przez metodę Select .
DataSet	Pierwszy DataTable z DataSet nich jest wyodrębniany, a DataView element jest tworzony i zwracany przez metodę Select .
Object	Obiekt jest opakowany w kolekcji jednego elementu IEnumerable i zwracany przez metodę Select .

Metoda, która jest identyfikowana przez SelectMethod właściwość, może być metodą wystąpienia lub static (Shared w Visual Basic). Jeśli jest to metoda wystąpienia, obiekt biznesowy jest tworzony i niszczony za każdym razem, gdy metoda określona przez SelectMethod właściwość jest wywoływana, z wyjątkiem tego, że to samo wystąpienie jest używane do wywoływania metody określonej przez SelectMethod właściwość i metody określonej przez SelectCountMethod właściwość. Metoda Select zwraca IEnumerable interfejs. Jednak aby włączyć scenariusze buforowania i filtrowania, wartość zwracana musi być obiektem DataSet . DataSet Chociaż klasa nie implementuje interfejsuIEnumerable, ObjectDataSource kontrolka automatycznie wyodrębnia domyślną DataView kontrolkęIEnumerable, która implementuje element .

Przed wykonaniem Select operacji wywoływana OnSelecting jest metoda w celu wywołania Selecting zdarzenia. Zdarzenie można obsłużyć Selecting w celu zbadania wartości parametrów i wykonania dowolnego przetwarzania wstępnego przed operacją Select . Aby wykonać operację pobierania danych, ObjectDataSourceView obiekt używa odbicia w celu utworzenia wystąpienia obiektu identyfikowanego przez TypeName właściwość. Następnie wywołuje metodę SelectMethod , która jest identyfikowana przez właściwość, przy użyciu dowolnych skojarzonych SelectParameters właściwości. Po zakończeniu Select operacji metoda jest wywoływana OnSelected , aby zgłosić Selected zdarzenie. Zdarzenie można obsłużyć Selected w celu zbadania wszystkich wartości zwracanych, parametrów wyjściowych i wyjątków oraz wykonania dowolnego przetwarzania końcowego.

SelectMethod Jeśli właściwość zwraca DataSetobiekt , DataTablelub DataView i buforowanie jest włączona, ObjectDataSource funkcja pobiera dane z pamięci podręcznej i zapisuje dane w pamięci podręcznej Select podczas operacji. Pamięć podręczna jest tworzona, odrzucana lub odświeżona na podstawie zachowania buforowania określonego CacheDuration przez kombinację właściwości i CacheExpirationPolicy .

SelectMethod Jeśli właściwość zwraca DataSet obiekt lubDataTable, a FilterExpression właściwość została określona, jest obliczana z dowolnymi podanymi FilterParameters właściwościami, a wynikowy filtr jest stosowany do listy danych podczas Select operacji.

Metoda Select deleguje do Select metody skojarzonej ObjectDataSourceView z kontrolką ObjectDataSource .

Aby uzyskać więcej informacji na temat scalania parametrów, okresu istnienia obiektu i rozpoznawania metod, zobacz SelectMethod.

kontrolki Data-Bound

Gdy kontrolka ObjectDataSource jest skojarzona z kontrolką związaną z danymi, taką jak kontrolka GridView , nie jest konieczne wywołanie Select metody z kodu strony. Metoda Select jest wywoływana bezpośrednio przez kontrolkę powiązana z danymi.

Dotyczy