ObjectDataSource.Select 方法

定义

通过用 SelectMethod 集合中的参数调用由 SelectParameters 属性标识的方法,从基础数据存储中检索数据。

public:
 System::Collections::IEnumerable ^ Select();
public System.Collections.IEnumerable Select ();
member this.Select : unit -> System.Collections.IEnumerable
Public Function Select () As IEnumerable

返回

一个数据行的 IEnumerable 列表。

示例

有关代码示例,请参阅 ObjectDataSource

注解

指定的方法可能具有任何方法签名,但它必须返回或派生自下表中列出的类型之一,控件 ObjectDataSource 才能成功调用它。

返回类型 操作
IEnumerable IEnumerableSelect 方法返回。
DataTable DataView通过使用 DataTable 创建 ,并由 Select 方法返回。
DataView DataViewSelect 方法返回。
DataSet 提取的第DataSetDataTableDataView ,并由 方法创建并返回 Select
Object 对象包装在单元素 IEnumerable 集合中,并由 Select 方法返回。

属性 SelectMethod 标识的方法可以是实例方法,也可以是 static Visual Basic) Shared 方法中的 (。 如果它是实例方法,则每次调用属性指定 SelectMethod 的方法时,都会创建并销毁业务对象,但使用相同的实例来调用由 SelectMethod 属性指定的方法和 属性指定的 SelectCountMethod 方法。 方法 Select 返回 接口 IEnumerable 。 但是,若要启用缓存和筛选方案,返回值必须是 DataSet 对象。 DataSet虽然 类不实现 IEnumerable 接口,但 ObjectDataSource 控件会自动提取实现 的默认DataView控件IEnumerable

在执行 Select 操作之前, OnSelecting 将调用 方法来引发 Selecting 事件。 可以处理 事件以 Selecting 检查参数的值,并在操作之前 Select 执行任何预处理。 为了执行数据检索操作, ObjectDataSourceView 对象使用反射来创建由 TypeName 属性标识的 对象的实例。 然后,它使用任何关联的SelectParameters属性调用由 SelectMethod 属性标识的方法。 操作 Select 完成后, OnSelected 将调用 方法来引发 Selected 事件。 可以处理 Selected 事件以检查任何返回值、输出参数和异常,并执行任何后处理。

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

如果属性 SelectMethod 返回 DataSetDataTable 对象,并且 FilterExpression 已指定属性,则会使用提供 FilterParameters 的任何属性对其进行计算,并在操作期间 Select 将生成的筛选器应用于数据列表。

方法Select委托给Select与 控件关联的 ObjectDataSourceObjectDataSourceView 方法。

有关参数合并、对象生存期和方法解析的详细信息,请参阅 SelectMethod

数据绑定控件

ObjectDataSource 控件与数据绑定控件(如 GridView 控件)关联时,无需从页面代码调用 Select 方法。 方法 Select 由数据绑定控件直接调用。

适用于

另请参阅