ObjectDataSource.Select 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
通过用 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 | 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 由数据绑定控件直接调用。
适用于
另请参阅
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈