ObjectDataSourceView.ExecuteSelect(DataSourceSelectArguments) Metoda

Definicja

Przestrzeń nazw:

System.Web.UI.WebControls

Zestaw:

System.Web.dll

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.IEnumerable

Protected Friend Overrides Function ExecuteSelect (arguments As DataSourceSelectArguments) As IEnumerable

Parametry

arguments

DataSourceSelectArguments

Element DataSourceSelectArguments służący do żądania operacji na danych wykracza poza podstawowe pobieranie danych.

Zwraca

IEnumerable

IEnumerable Lista wierszy danych.

Wyjątki

NotSupportedException

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.

InvalidOperationException

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.

Zobacz też

• Select(DataSourceSelectArguments)
• SelectMethod
• SelectCountMethod
• OnSelecting(ObjectDataSourceSelectingEventArgs)
• OnSelected(ObjectDataSourceStatusEventArgs)
• Selecting
• Selected