ObjectDataSourceView.ExecuteSelect(DataSourceSelectArguments) Метод

Определение

Извлекает данные из объекта, заданного свойством TypeName, вызвав метод, указанный в свойстве SelectMethod, и передав значения в коллекцию SelectParameters.Retrieves data from the object that is identified by the TypeName property by calling the method that is identified by the SelectMethod property and passing any values in the SelectParameters collection.

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, используемый для операций запроса данных вне пределов извлечения базовых данных.A DataSourceSelectArguments used to request operations on the data beyond basic data retrieval.

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

IEnumerable

Список строк данных IEnumerable.A IEnumerable list of data rows.

Исключения

Параметр arguments, передаваемый методу ExecuteSelect(DataSourceSelectArguments), указывает на то, что при извлечении данных источник данных должен выполнить определенные дополнительные действия, чтобы обеспечить возможность разбиения по страницам или сортировки извлеченных данных, однако элемент управления источником данных не поддерживает запрашиваемые возможности.The arguments passed to the ExecuteSelect(DataSourceSelectArguments) method specify that the data source should perform some additional work while retrieving data to enable paging or sorting through the retrieved data, but the data source control does not support the requested capability.

-или--or- Объект, возвращенный методом ExecuteSelect(DataSourceSelectArguments), не является объектом DataSet или DataTable, а кэширование разрешено.The object returned by the ExecuteSelect(DataSourceSelectArguments) method is not a DataSet or DataTable, and caching is enabled. Для элемента управления DataSet допускается кэширование только объектов DataTable и ObjectDataSourceView.Only DataSet and DataTable objects can be cached for the ObjectDataSourceView control.

-или--or- Разрешено как кэширование, так и олицетворение клиента.Both caching and client impersonation are enabled. Объект ObjectDataSource не поддерживает кэширование при разрешенном олицетворении клиента.The ObjectDataSource does not support caching when client impersonation is enabled.

Объект, возвращенный методом ExecuteSelect(DataSourceSelectArguments), является объектом DataSet, однако в его коллекции Tables отсутствуют таблицы.The object returned by the ExecuteSelect(DataSourceSelectArguments) method is a DataSet, but has no tables in its Tables collection.

-или--or- Для свойства EnablePaging задано значение true, однако при этом не заданы свойства StartRowIndexParameterName и MaximumRowsParameterName.The EnablePaging property is set to true, but the StartRowIndexParameterName and MaximumRowsParameterName properties are not set.

Комментарии

ObjectDataSourceViewКласс реализует наследуемый ExecuteSelect метод для получения данных с помощью бизнес-объекта.The ObjectDataSourceView class implements the inherited ExecuteSelect method to retrieve data using a business object. Разработчики страниц и элементы управления с привязкой к данным не вызывают ExecuteSelect метод напрямую; вместо этого используйте общедоступный Select метод.Page developers and data-bound control authors do not call the ExecuteSelect method directly; instead, use the publicly exposed Select method.

Указанный метод может иметь любую сигнатуру метода, но должен возвращать один из типов для ObjectDataSource элемента управления, перечисленных в следующей таблице для успешного вызова.The specified method can have any method signature, but must return one of the types for the ObjectDataSource control that are listed in the following table to call it successfully.

Возвращаемый типReturn type ДействиеAction
IEnumerable IEnumerable Select Метод возвращается методом.The IEnumerable is returned by the Select method.
DataTable DataViewСоздается с помощью DataTable и возвращается Select методом.A DataView is created using the DataTable and returned by the Select method.
DataSet Первый DataTable из DataSet извлекается и DataView создается и возвращается Select методом.The first DataTable of the DataSet is extracted and a DataView is created and returned by the Select method.
Object Объект упаковывается в один элемент IEnumerable и возвращается Select методом.The object is wrapped in a one-element IEnumerable and returned by the Select method.

Перед выполнением извлечения данных OnSelecting вызывается метод для вызова Selecting события.Before the data retrieval is performed, the OnSelecting method is called to raise the Selecting event. Это событие можно обработать для проверки значений параметров и выполнения предварительной обработки перед операцией.You can handle this event to examine the values of the parameters and to perform any preprocessing before an operation.

Для выполнения операции SELECT ObjectDataSourceView элемент управления использует отражение для вызова метода, определяемого SelectMethod свойством, и всех связанных параметров в SelectParameters коллекции, а затем выполняет его.To perform a select operation, the ObjectDataSourceView control uses reflection to call the method that is identified by the SelectMethod property and any associated parameters that are in the SelectParameters collection, and then executes it. После завершения операции OnSelected вызывается метод для вызова Selected события.After the operation completes, the OnSelected method is called to raise the Selected event. Это событие можно обработать для проверки любых возвращаемых значений и кодов ошибок, а также для выполнения любой последующей обработки.You can handle this event to examine any return values and error codes, and to perform any post-processing.

Если Select метод возвращает DataSet объект и включено кэширование, ObjectDataSourceView извлекает данные из кэша и сохраняет их во время операции.If the Select method returns a DataSet object and caching is enabled, the ObjectDataSourceView retrieves data from and saves data to the cache during the operation. Кэш создается, удаляется или обновляется в зависимости от поведения кэширования, заданного сочетанием CacheDuration CacheExpirationPolicy свойств и.The cache is created, discarded, or refreshed based on the caching behavior that is specified by the combination of the CacheDuration and CacheExpirationPolicy properties.

Если Select метод возвращает DataSet объект и FilterExpression свойство было задано, оно вычисляется вместе с любыми предоставленными FilterParameters свойствами, а результирующий фильтр применяется к списку данных во время Select операции.If the Select method returns a DataSet object and a FilterExpression property has been specified, it is evaluated along with any supplied FilterParameters properties and the resulting filter is applied to the list of data during the Select operation.

Дополнительные сведения о возврате количества выбранных строк см. в разделе Select .For information on returning the number of rows selected, see Select.

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

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