SqlDataSourceView.ExecuteSelect(DataSourceSelectArguments) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Извлекает данные из основной базы данных, используя SQL-строку SelectCommand и параметры, содержащиеся в коллекции 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.IEnumerableProtected Friend Overrides Function ExecuteSelect (arguments As DataSourceSelectArguments) As IEnumerableПараметры
- arguments
- DataSourceSelectArguments
Объект DataSourceSelectArguments, используемый для операций запроса данных вне пределов извлечения базовых данных.
Возвращаемое значение
Список строк данных IEnumerable.
Исключения
Параметр arguments, передаваемый методу ExecuteSelect(DataSourceSelectArguments), указывает на то, что при извлечении данных источник данных должен выполнить определенные дополнительные действия, чтобы обеспечить возможность разбиения по страницам или сортировки извлеченных данных, однако элемент управления источником данных не поддерживает запрашиваемые возможности.
-или-
Кэширование поддерживается, однако для свойства DataSourceMode источника данных не задано значение DataSet.
-или-
Свойство SortParameterName задано, однако для свойства CommandType не установлено значение StoredProcedure.
Источнику данных не удается создать подключение к базе данных.
-или-
Кэширование поддерживается, однако тип внутреннего кэша и тип команды не совпадают.
Комментарии
Класс SqlDataSourceView реализует наследуемый ExecuteSelect метод для получения данных из базы данных. Разработчики страниц и авторы элементов управления с привязкой к данным не вызывают ExecuteSelect метод напрямую, а используют открытый Select метод.
Перед выполнением извлечения данных вызывается OnSelecting метод для вызова Selecting события . Это событие можно обработать, чтобы проверить значения параметров и выполнить предварительную обработку перед извлечением данных.
Для выполнения операции SqlDataSourceView объект создает DbCommand объект с использованием SelectCommand текста и всех связанных SelectParametersс ней объектов и выполняет его для базовой базы данных. После завершения операции вызывается метод для OnSelected вызова Selected события . Это событие можно обработать для проверки возвращаемых значений, кодов ошибок и выполнения постобработки.
Метод ExecuteSelect возвращает объект , DataView если DataSourceMode для задано значение DataSet, или объект , IDataReader если DataSourceMode для задано значение DataReader. Закройте объект, IDataReader когда завершите чтение данных.
DataSourceMode Если для задано значение DataSet и кэширование SqlDataSourceView включено, объект извлекает данные из и сохраняет их в кэше во время операции с данными. Кэш создается, удаляется или обновляется в зависимости от поведения кэширования, заданного сочетанием CacheDuration свойств и CacheExpirationPolicy .
Важно!
При использовании олицетворения клиента в проверка подлинности Windows данные кэшируются, когда первый пользователь обращается к данным. Если другой пользователь запрашивает те же данные, данные извлекаются из кэша. Данные не извлекаются путем другого вызова базы данных для проверки доступа пользователя к данным. Если вы ожидаете, что несколько пользователей будут получать доступ к данным и хотите, чтобы каждое извлечение данных проверялось конфигурациями безопасности базы данных, не используйте кэширование.
DataSourceMode Если для задано значение DataSet и FilterExpression задано значение , он вычисляется вместе с любым предоставленнымFilterParameters, а результирующий фильтр применяется к списку данных во время операции извлечения данных.
