ObjectDataSourceView.ExecuteSelect(DataSourceSelectArguments) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Извлекает данные из объекта, заданного свойством TypeName, вызвав метод, указанный в свойстве SelectMethod, и передав значения в коллекцию 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), указывает на то, что при извлечении данных источник данных должен выполнить определенные дополнительные действия, чтобы обеспечить возможность разбиения по страницам или сортировки извлеченных данных, однако элемент управления источником данных не поддерживает запрашиваемые возможности.
-или-
Объект, возвращенный методом ExecuteSelect(DataSourceSelectArguments), не является объектом DataSet или DataTable, а кэширование разрешено. Для элемента управления DataSet допускается кэширование только объектов DataTable и ObjectDataSourceView.
-или-
Разрешено как кэширование, так и олицетворение клиента. Объект ObjectDataSource не поддерживает кэширование при разрешенном олицетворении клиента.
Объект, возвращенный методом ExecuteSelect(DataSourceSelectArguments), является объектом DataSet, однако в его коллекции Tables отсутствуют таблицы.
-или-
Для свойства EnablePaging задано значение true, однако при этом не заданы свойства StartRowIndexParameterName и MaximumRowsParameterName.
Комментарии
Класс ObjectDataSourceView реализует наследуемый ExecuteSelect метод для получения данных с помощью бизнес-объекта. Разработчики страниц и авторы элементов управления, привязанных к данным, не вызывают ExecuteSelect метод напрямую. Вместо этого используйте открытый Select метод.
Указанный метод может иметь любую сигнатуру метода, но должен возвращать один из типов для ObjectDataSource элемента управления, перечисленных в следующей таблице, чтобы его успешно вызвать.
| Возвращаемый тип | Действие |
|---|---|
| IEnumerable | Возвращается IEnumerable методом Select . |
| DataTable | Создается DataView с помощью DataTable и возвращается методом Select . |
| DataSet | Первый DataTable из DataSet извлекается, и DataView создается и возвращается методом Select . |
| Object | Объект упаковывается в один элемент IEnumerable и возвращается методом Select . |
Перед выполнением извлечения OnSelecting данных вызывается метод для вызова Selecting события . Это событие можно обработать для проверки значений параметров и выполнения любой предварительной обработки перед операцией.
Для выполнения операции выбора элемент управления использует отражение для вызова метода, ObjectDataSourceView определяемого свойством SelectMethod и любыми связанными параметрами в SelectParameters коллекции, а затем выполняет его. После завершения OnSelected операции вызывается метод для вызова Selected события . Это событие можно обработать для проверки любых возвращаемых значений и кодов ошибок, а также для выполнения любой последующей обработки.
Select Если метод возвращает DataSet объект и кэширование включено, ObjectDataSourceView метод извлекает данные из кэша и сохраняет их в кэше во время операции. Кэш создается, удаляется или обновляется на основе поведения кэширования, заданного сочетанием CacheDuration свойств и CacheExpirationPolicy .
Select Если метод возвращает DataSet объект и FilterExpression свойство указано, он вычисляется вместе с любыми предоставленными FilterParameters свойствами, а результирующий фильтр применяется к списку данных во время Select операции.
Сведения о возврате количества выбранных строк см. в разделе Select.
