DataTableReader 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
DataTableReader 以一个或多个只读、仅向前结果集的形式获取一个或多个 DataTable 对象的内容。
public ref class DataTableReader sealed : System::Data::Common::DbDataReader
public sealed class DataTableReader : System.Data.Common.DbDataReader
type DataTableReader = class
inherit DbDataReader
Public NotInheritable Class DataTableReader
Inherits DbDataReader
- 继承
注解
DataTableReader 的工作方式与任何其他数据读取器(如 SqlDataReader)非常类似,不同之处在于,DataTableReader 提供循环访问 DataTable中的行。 换句话说,它提供循环访问缓存中的行。 当 DataTableReader 处于活动状态时,可以修改缓存的数据,并且读取器会自动维护其位置。
从 DataTable创建 DataTableReader 时,生成的 DataTableReader 对象包含一个结果集,其数据与创建 DataTable 相同,但标记为已删除的任何行除外。 列的显示顺序与原始 DataTable相同。 返回结果的结构在架构和数据中与原始 DataTable相同。 通过调用 DataSet 对象的 CreateDataReader 方法创建的 DataTableReader 包含多个结果集(如果 DataSet 包含多个表)。 结果与 DataSet 对象的 DataTableCollection 中的 DataTable 对象的顺序相同。
返回的结果集仅包含每个 DataRow的当前版本;将跳过标记为要删除的行。
DataTableReader
提供稳定的迭代器;也就是说,如果在迭代期间修改基础集合的大小,则 DataTableReader
的内容不会失效。 例如,如果在迭代期间删除或删除 Rows 集合中的一行或多行,则 DataTableReader
中的当前位置得到适当维护,并且不会使迭代器失效。
构造函数
DataTableReader(DataTable) |
使用提供的 DataTable中的数据初始化 DataTableReader 类的新实例。 |
DataTableReader(DataTable[]) |
使用提供的 DataTable 对象的数组初始化 DataTableReader 类的新实例。 |
属性
Depth |
DataTableReader当前行的嵌套深度。 |
FieldCount |
返回当前行中的列数。 |
HasRows |
获取一个值,该值指示 DataTableReader 是否包含一行或多行。 |
IsClosed |
获取一个值,该值指示是否关闭 DataTableReader。 |
Item[Int32] |
获取给定列序号的指定列的本机格式的值。 |
Item[String] |
获取给定列名称的本机格式指定列的值。 |
RecordsAffected |
获取通过执行 SQL 语句插入、更改或删除的行数。 |
VisibleFieldCount |
获取未隐藏的 DbDataReader 中的字段数。 (继承自 DbDataReader) |
方法
显式接口实现
IDataRecord.GetData(Int32) |
有关此成员的说明,请参阅 GetData(Int32)。 (继承自 DbDataReader) |