ObjectDataSource.Select 方法

  • 参考

定义

命名空间:
System.Web.UI.WebControls
程序集:
System.Web.dll

通过用 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

一个数据行的 IEnumerable 列表。

示例

有关代码示例，请参阅 ObjectDataSource。

注解

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

返回类型 操作
IEnumerable IEnumerable由 Select 方法返回 。
DataTable DataView使用 DataTable 创建 ，并由 Select 方法返回。
DataView DataView由 Select 方法返回 。
DataSet 提取第一DataTable个 DataView ，DataSet然后由 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如果 属性返回 DataSet、 DataTable或 DataView 对象并启用了缓存，则 ObjectDataSource 从中检索数据并在操作期间Select将数据保存到缓存。 缓存根据 和 CacheExpirationPolicy 属性的组合CacheDuration指定的缓存行为创建、丢弃或刷新。

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

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

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

数据绑定控件

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

适用于

另请参阅