ObjectDataSourceView.ExecuteSelect(DataSourceSelectArguments) Metoda
Definicja
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 obiektu, który jest identyfikowany przez TypeName właściwość, wywołując metodę, która jest identyfikowana przez SelectMethod właściwość i przekazując dowolne wartości w SelectParameters kolekcji.
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
Element DataSourceSelectArguments służący do żądania operacji na danych wykracza poza podstawowe pobieranie danych.
Zwraca
IEnumerable Lista wierszy danych.
Wyjątki
Metoda arguments przekazana do ExecuteSelect(DataSourceSelectArguments) metody określa, że źródło danych powinno wykonać dodatkową pracę podczas pobierania danych w celu włączenia stronicowania lub sortowania pobranych danych, ale kontrola źródła danych nie obsługuje żądanej możliwości.
-lub-
Obiekt zwracany przez metodę ExecuteSelect(DataSourceSelectArguments) nie jest obiektem DataSet lub DataTable, a buforowanie jest włączone. Tylko DataSet obiekty i DataTable mogą być buforowane dla kontrolki ObjectDataSourceView .
-lub-
Buforowanie i personifikacja klienta są włączone. Funkcja ObjectDataSource nie obsługuje buforowania, gdy jest włączona personifikacja klienta.
Obiekt zwracany przez metodę ExecuteSelect(DataSourceSelectArguments) jest obiektem DataSet, ale nie ma tabel w swojej Tables kolekcji.
-lub-
Właściwość jest ustawiona EnablePaging na truewartość , ale StartRowIndexParameterName właściwości i MaximumRowsParameterName nie są ustawione.
Uwagi
Klasa ObjectDataSourceView implementuje dziedziczona ExecuteSelect metodę w celu pobrania danych przy użyciu obiektu biznesowego. Deweloperzy stron i autorzy kontrolek powiązanych z danymi nie nazywają ExecuteSelect metody bezpośrednio. Zamiast tego należy użyć publicznie uwidocznionej Select metody.
Określona metoda może mieć dowolny podpis metody, ale musi zwrócić jeden z typów dla ObjectDataSource kontrolki wymienionej w poniższej tabeli, aby wywołać ją pomyślnie.
| Typ zwracany | Akcja |
|---|---|
| IEnumerable | Element IEnumerable jest zwracany przez metodę Select . |
| DataTable | Element jest DataView tworzony przy użyciu DataTable metody i zwracanej przez metodę Select . |
| DataSet | Pierwszy DataTable element jest wyodrębniany, a DataView element jest tworzony i zwracany przez metodę SelectDataSet . |
| Object | Obiekt jest owinięty w jeden element IEnumerable i zwracany przez metodę Select . |
Przed pobraniem danych wywoływana OnSelecting jest metoda w celu wywołania Selecting zdarzenia. To zdarzenie można obsłużyć w celu zbadania wartości parametrów i wykonania dowolnego przetwarzania wstępnego przed operacją.
Aby wykonać operację wybierania, kontrolka ObjectDataSourceView używa odbicia w celu wywołania metody identyfikowanej przez SelectMethod właściwość i wszelkich skojarzonych parametrów, które znajdują się w SelectParameters kolekcji, a następnie wykonuje ją. Po zakończeniu operacji wywoływana OnSelected jest metoda w celu wywołania Selected zdarzenia. To zdarzenie można obsłużyć w celu zbadania wszystkich zwracanych wartości i kodów błędów oraz wykonania dowolnego przetwarzania końcowego.
Select Jeśli metoda zwraca DataSet obiekt i buforowanie jest włączone, ObjectDataSourceView metoda pobiera dane z i zapisuje dane w pamięci podręcznej 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 .
Select Jeśli metoda zwraca DataSet obiekt, a FilterExpression właściwość została określona, jest obliczana wraz z wszelkimi podanymi FilterParameters właściwościami, a wynikowy filtr jest stosowany do listy danych podczas Select operacji.
Aby uzyskać informacje na temat zwracania liczby wybranych wierszy, zobacz Select.
