SqlDataSourceView.ExecuteSelect(DataSourceSelectArguments) Metoda

  • Odwołanie

Definicja

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

Pobiera dane z bazowej bazy danych przy użyciu SelectCommand ciągu SQL i wszystkich parametrów, które znajdują się 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

DataSourceSelectArguments Obiekt używany do żądania operacji na danych wykracza poza podstawowe pobieranie danych.

Zwraca

IEnumerable

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

Buforowanie jest włączone, ale DataSourceMode właściwość źródła danych nie jest ustawiona na DataSetwartość .

-lub-

Właściwość jest ustawiona SortParameterName , ale CommandType nie jest ustawiona na StoredProcedurewartość .

InvalidOperationException

Źródło danych nie może utworzyć połączenia z bazą danych.

-lub-

Buforowanie jest włączone, ale wewnętrzna pamięć podręczna i typy poleceń nie są zgodne.

Uwagi

Klasa SqlDataSourceView implementuje dziedziczona ExecuteSelect metodę w celu pobrania danych z bazy danych. 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.

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 pobraniem danych.

Aby wykonać operację, SqlDataSourceView obiekt kompiluje obiekt przy użyciu SelectCommand tekstu i skojarzonych SelectParametersobiektów i wykonuje go względem bazowej bazy DbCommand danych. Po zakończeniu operacji wywoływana OnSelected jest metoda w celu wywołania Selected zdarzenia. To zdarzenie można obsłużyć w celu sprawdzenia wszystkich wartości zwracanych, kodów błędów i wykonania dowolnego przetwarzania końcowego.

Metoda ExecuteSelect zwraca DataView obiekt, jeśli DataSourceMode obiekt jest ustawiony na DataSetwartość , lub IDataReader obiekt, jeśli DataSourceMode parametr jest ustawiony na DataReaderwartość . Zamknij obiekt po zakończeniu IDataReader odczytywania danych.

DataSourceMode Jeśli parametr jest ustawiony na DataSet i buforowanie jest włączone, SqlDataSourceView program pobiera dane z pamięci podręcznej i zapisuje je w pamięci podręcznej podczas operacji 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 .

Ważne

W przypadku korzystania z personifikacji klienta w ramach uwierzytelniania systemu Windows dane są buforowane, gdy pierwszy użytkownik uzyskuje dostęp do danych. Jeśli inny użytkownik zażąda tych samych danych, dane są pobierane z pamięci podręcznej. Dane nie są pobierane przez wykonanie innego wywołania bazy danych w celu zweryfikowania dostępu użytkownika do danych. Jeśli oczekujesz, że wielu użytkowników będzie uzyskiwać dostęp do danych i chcesz, aby każde pobieranie danych było weryfikowane przez konfiguracje zabezpieczeń bazy danych, nie należy używać buforowania.

DataSourceMode Jeśli parametr jest ustawiony na DataSet wartość i FilterExpression został określony, jest obliczany wraz z dowolnym podanym FilterParameters elementem, a wynikowy filtr jest stosowany do listy danych podczas operacji pobierania danych.

Dotyczy

Zobacz też