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 Список строк данных.
Исключения
ExecuteSelect(DataSourceSelectArguments) Переданный arguments метод указывает, что источник данных должен выполнять некоторую дополнительную работу при извлечении данных для включения разбиения по страницам или сортировки по извлеченным данным, но управление источником данных не поддерживает запрошенную возможность.
–или–
Объект, возвращаемый ExecuteSelect(DataSourceSelectArguments) методом DataSet , не является или DataTableвключен кэширование. DataTable Для элемента управления можно кэшировать ObjectDataSourceView только DataSet объекты.
–или–
Кэширование и олицетворение клиента включены. Кэширование ObjectDataSource не поддерживается при включении олицетворения клиента.
Объект, возвращаемый методом ExecuteSelect(DataSourceSelectArguments) , является объектом DataSet, но не содержит таблиц в коллекции Tables .
–или–
Для EnablePaging свойства задано trueзначение, но StartRowIndexParameterNameMaximumRowsParameterName свойства не заданы.
Комментарии
Класс 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.
