AccessDataSourceView.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.IEnumerable
Protected Friend Overrides Function ExecuteSelect (arguments As DataSourceSelectArguments) As IEnumerable

Параметры

arguments
DataSourceSelectArguments

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

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

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

Исключения

Свойство DataFile имеет значение null или пустая строка ("").

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

Комментарии

Объект AccessDataSourceView переопределяет ExecuteSelect метод , чтобы убедиться, что DataFile свойство связанного AccessDataSource элемента управления задано перед получением данных.

Перед выполнением ExecuteSelectOnSelecting метода вызывается метод для вызова Selecting события . Вы можете обработать Selecting событие для проверки значений параметров и выполнения любой предварительной обработки перед операцией извлечения данных.

Чтобы выполнить извлечение данных, AccessDataSourceView объект создает IDbCommand объект с использованием SelectCommand текста и всех связанных SelectParameters свойств. AccessDataSourceView Затем объект выполняет объект в базовом IDbCommand хранилище данных. После завершения операции вызывается метод для OnSelected вызова Selected события . Вы можете обработать Selected событие для проверки возвращаемых значений и кодов ошибок, а также для выполнения постобработки.

DataSourceMode Если для свойства задано DataSet значение и кэширование включено, AccessDataSourceView объект извлекает данные из кэша и сохраняет их в кэше во время операции извлечения данных. Кэш создается, удаляется или обновляется в зависимости от поведения кэширования, заданного сочетанием CacheDuration свойств и CacheExpirationPolicy .

Если свойству DataSourceMode присвоено DataSet значение и FilterExpression свойство задано, DataSourceMode свойство вычисляется вместе с любыми предоставленными FilterParameters свойствами, а результирующий фильтр применяется к списку данных во время Select операции.

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

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