SqlDataSourceView.ExecuteSelect(DataSourceSelectArguments) Метод

  • Ссылка

Определение

Пространство имен:
System.Web.UI.WebControls
Сборка:
System.Web.dll

Извлекает данные из основной базы данных, используя 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.IEnumerable
Protected Friend Overrides Function ExecuteSelect (arguments As DataSourceSelectArguments) As IEnumerable

Параметры

arguments
DataSourceSelectArguments

Объект DataSourceSelectArguments, используемый для операций запроса данных вне пределов извлечения базовых данных.

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

IEnumerable

Список строк данных IEnumerable.

Исключения

NotSupportedException

Параметр arguments, передаваемый методу ExecuteSelect(DataSourceSelectArguments), указывает на то, что при извлечении данных источник данных должен выполнить определенные дополнительные действия, чтобы обеспечить возможность разбиения по страницам или сортировки извлеченных данных, однако элемент управления источником данных не поддерживает запрашиваемые возможности.

-или-

Кэширование поддерживается, однако для свойства DataSourceMode источника данных не задано значение DataSet.

-или-

Свойство SortParameterName задано, однако для свойства CommandType не установлено значение StoredProcedure.

InvalidOperationException

Источнику данных не удается создать подключение к базе данных.

-или-

Кэширование поддерживается, однако тип внутреннего кэша и тип команды не совпадают.

Комментарии

Класс 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, а результирующий фильтр применяется к списку данных во время операции извлечения данных.

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

См. также раздел