AccessDataSourceView.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 magazynu danych bazowych przy użyciu ciągu SQL we SelectCommand właściwości i wszystkich parametrów w kolekcji SelectParameters .
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 wykraczających poza podstawowe pobieranie danych.
Zwraca
Wiersze IEnumerable danych.
Wyjątki
Właściwość DataFile jest lub jest null
pustym ciągiem ("").
Przekazana arguments
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.
Uwagi
Obiekt AccessDataSourceView zastępuje metodę ExecuteSelect , aby upewnić się, że DataFile właściwość skojarzonej kontrolki AccessDataSource jest ustawiana przed pobraniem danych.
Przed wykonaniem ExecuteSelect metody metoda jest wywoływana OnSelecting 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ą pobierania danych.
Aby wykonać pobieranie danych, AccessDataSourceView obiekt tworzy IDbCommand obiekt przy użyciu SelectCommand tekstu i skojarzonych SelectParameters właściwości. AccessDataSourceView Następnie obiekt wykonuje IDbCommand obiekt względem bazowego magazynu danych. Po zakończeniu operacji metoda jest wywoływana OnSelected , aby zgłosić Selected zdarzenie. Zdarzenie można obsłużyć w Selected celu sprawdzenia wszystkich zwracanych wartości i kodów błędów oraz wykonania dowolnego przetwarzania końcowego.
DataSourceMode Jeśli właściwość jest ustawiona na DataSet wartość i buforowanie jest włączone, AccessDataSourceView pobiera dane z pamięci podręcznej i zapisuje dane w pamięci podręcznej podczas operacji pobierania danych. 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 .
DataSourceMode Jeśli właściwość jest ustawiona na DataSet wartość, a FilterExpression właściwość została określona, DataSourceMode właściwość jest oceniana wraz z wszelkimi podanymi FilterParameters właściwościami, a wynikowy filtr jest stosowany do listy danych podczas Select operacji.