ObjectDataSourceView.ExecuteSelect(DataSourceSelectArguments) Метод

Определение

Пространство имен:

System.Web.UI.WebControls

Сборка:

System.Web.dll

Извлекает данные из объекта, заданного свойством 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.IEnumerable

Protected Friend Overrides Function ExecuteSelect (arguments As DataSourceSelectArguments) As IEnumerable

Параметры

arguments

DataSourceSelectArguments

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

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

IEnumerable

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

Исключения

NotSupportedException

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

-или-

Объект, возвращенный методом ExecuteSelect(DataSourceSelectArguments), не является объектом DataSet или DataTable, а кэширование разрешено. Для элемента управления DataSet допускается кэширование только объектов DataTable и ObjectDataSourceView.

-или-

Разрешено как кэширование, так и олицетворение клиента. Объект ObjectDataSource не поддерживает кэширование при разрешенном олицетворении клиента.

InvalidOperationException

Объект, возвращенный методом 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.

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

• Select(DataSourceSelectArguments)
• SelectMethod
• SelectCountMethod
• OnSelecting(ObjectDataSourceSelectingEventArgs)
• OnSelected(ObjectDataSourceStatusEventArgs)
• Selecting
• Selected