通过

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

传递给 ExecuteSelect(DataSourceSelectArguments) 方法的 arguments 指定数据源在检索数据时应执行一些附加操作，以便对检索到的数据启用分页或排序，但此数据源控件不支持请求的功能。

- 或 -

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 使用 DataViewDataTable 创建 ，并由 Select 方法返回。
DataSet 提取的第DataSet一DataTable个 DataView ，并由 方法创建并返回 Select 。
Object 对象包装在一个元素 IEnumerable 中，并由 Select 方法返回。

在执行数据检索之前， OnSelecting 将调用 方法来引发 Selecting 事件。 可以处理此事件来检查参数的值，并在操作之前执行任何预处理。

为了执行选择操作， ObjectDataSourceView 控件使用反射调用由 SelectMethod 属性和集合中的任何 SelectParameters 关联参数标识的方法，然后执行该方法。 操作完成后， OnSelected 将调用 方法来引发 Selected 事件。 可以处理此事件以检查任何返回值和错误代码，并执行任何后处理。

Select如果 方法返回 对象DataSet并启用缓存，则 ObjectDataSourceView 在操作期间从中检索数据并将数据保存到缓存。 根据 和 CacheExpirationPolicy 属性的组合CacheDuration指定的缓存行为创建、丢弃或刷新缓存。

Select如果方法返回 对象DataSet且FilterExpression已指定属性，则会与提供FilterParameters的任何属性一起计算该对象，并在操作期间Select将生成的筛选器应用于数据列表。

有关返回所选行数的信息，请参阅 Select。

适用于

另请参阅