SqlDataSourceView.ExecuteSelect(DataSourceSelectArguments) Метод

Определение

Извлекает данные из основной базы данных, используя SQL-строку SelectCommand и параметры, содержащиеся в коллекции SelectParameters.Retrieves data from the underlying database using the SelectCommand SQL string and any parameters that are in the SelectParameters collection.

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

Параметры

arguments
DataSourceSelectArguments

Объект DataSourceSelectArguments, используемый для операций запроса данных вне пределов извлечения базовых данных.A DataSourceSelectArguments object used to request operations on the data beyond basic data retrieval.

Возвращаемое значение

Список строк данных IEnumerable.An IEnumerable list of data rows.

Исключения

Параметр arguments, передаваемый методу ExecuteSelect(DataSourceSelectArguments), указывает на то, что при извлечении данных источник данных должен выполнить определенные дополнительные действия, чтобы обеспечить возможность разбиения по страницам или сортировки извлеченных данных, однако элемент управления источником данных не поддерживает запрашиваемые возможности.The arguments passed to the ExecuteSelect(DataSourceSelectArguments) method specify that the data source should perform some additional work while retrieving data to enable paging or sorting through the retrieved data, but the data source control does not support the requested capability.

- или --or- Кэширование поддерживается, однако для свойства DataSourceMode источника данных не задано значение DataSet.Caching is enabled but the DataSourceMode property of the data source is not set to DataSet.

- или --or- Свойство SortParameterName задано, однако для свойства CommandType не установлено значение StoredProcedure.The SortParameterName property is set but CommandType is not set to StoredProcedure.

Источнику данных не удается создать подключение к базе данных.The data source cannot create a database connection.

-или--or-

Кэширование поддерживается, однако тип внутреннего кэша и тип команды не совпадают.Caching is enabled but the internal cache and command types do not match.

Комментарии

Класс реализует наследуемый ExecuteSelect метод для получения данных из базы данных. SqlDataSourceViewThe SqlDataSourceView class implements the inherited ExecuteSelect method to retrieve data from a database. Разработчики страниц и элементы управления с привязкой к данным не вызывают ExecuteSelect метод напрямую; вместо этого используйте Select общедоступный метод.Page developers and data-bound control authors do not call the ExecuteSelect method directly; instead, use the publicly exposed Select method.

Перед выполнением извлечения OnSelecting данных вызывается метод для Selecting вызова события.Before the data retrieval is performed, the OnSelecting method is called to raise the Selecting event. Это событие можно обработать для проверки значений параметров и выполнения предварительной обработки перед извлечением данных.You can handle this event to examine the values of the parameters and to perform any preprocessing before data is retrieved.

Для выполнения операции SqlDataSourceView объект DbCommand создает объект, используя SelectCommand текст и все связанные SelectParametersс ним, и выполняет его в базовой базе данных.To perform the operation, the SqlDataSourceView object builds a DbCommand object using the SelectCommand text and any associated SelectParameters, and executes it against the underlying database. После завершения OnSelected операции вызывается метод для Selected вызова события.After the operation completes, the OnSelected method is called to raise the Selected event. Это событие можно обработать для проверки любых возвращаемых значений, кодов ошибок и выполнения любой последующей обработки.You can handle this event to examine any return values, error codes, and perform any post-processing.

IDataReader МетодвозвращаетDataSourceMode объект, DataSourceMode если имеет значение, или объект, DataReaderесли имеет значение. DataSet DataView ExecuteSelectThe ExecuteSelect method returns a DataView object if the DataSourceMode is set to DataSet, or a IDataReader object if the DataSourceMode is set to DataReader. Завершив IDataReader чтение данных, закройте объект.Close the IDataReader object when you have finished reading the data.

Если параметр DataSet SqlDataSourceView имеет значение и включено кэширование, то извлекает данные из кэша и сохраняет их во время операции с данными. DataSourceModeIf the DataSourceMode is set to DataSet and caching is enabled, the SqlDataSourceView retrieves data from and saves data to the cache during the data operation. Кэш создается, удаляется или обновляется в зависимости от поведения кэширования, заданного сочетанием CacheDuration свойств и. CacheExpirationPolicyThe cache is created, discarded, or refreshed based on the caching behavior specified by the combination of the CacheDuration and CacheExpirationPolicy properties.

Важно!

При использовании олицетворения клиента при проверке подлинности Windows данные кэшируются, когда первый пользователь обращается к данным.When you are using client impersonation under Windows authentication, the data is cached when the first user accesses the data. Если другой пользователь запрашивает одни и те же данные, данные извлекаются из кэша.If another user requests the same data, the data is retrieved from the cache. Данные не извлекаются путем совершения другого обращения к базе данных для проверки доступа пользователя к данным.The data is not retrieved by making another call to the database to verify the user's access to the data. Если требуется, чтобы несколько пользователей получали доступ к данным и каждый из них должен быть проверен в конфигурациях безопасности базы данных, не используйте кэширование.If you expect multiple users to access the data, and you want each retrieval to the data to be verified by the database's security configurations, do not use caching.

Если для DataSet задано значение и указано FilterExpression значение FilterParameters , оно вычисляется вместе с любыми указанными данными, а результирующий фильтр применяется к списку данных во время операции получения данных. DataSourceModeIf the DataSourceMode is set to DataSet and a FilterExpression has been specified, it is evaluated along with any supplied FilterParameters and the resulting filter is applied to the list of data during the data retrieval operation.

Применяется к

Дополнительно