DbDataReader 类

定义

命名空间:

System.Data.Common

程序集:

System.Data.Common.dll

Source:

DbDataReader.cs

从数据源中读取仅向前行流。

public ref class DbDataReader abstract : MarshalByRefObject, IAsyncDisposable, IDisposable, System::Collections::IEnumerable, System::Data::IDataReader

public abstract class DbDataReader : MarshalByRefObject, IAsyncDisposable, IDisposable, System.Collections.IEnumerable, System.Data.IDataReader

type DbDataReader = class
    inherit MarshalByRefObject
    interface IEnumerable
    interface IDataReader
    interface IDataRecord
    interface IDisposable
    interface IAsyncDisposable

Public MustInherit Class DbDataReader
Inherits MarshalByRefObject
Implements IAsyncDisposable, IDataReader, IDisposable, IEnumerable

继承

Object

MarshalByRefObject

DbDataReader

派生

System.Data.DataTableReader

System.Data.EntityClient.EntityDataReader

System.Data.Odbc.OdbcDataReader

System.Data.OleDb.OleDbDataReader

System.Data.SqlClient.SqlDataReader

实现

IEnumerable IDisposable IDataReader IDataRecord IAsyncDisposable

构造函数

DbDataReader()

初始化 DbDataReader 类的新实例。

属性

Depth	获取一个值，该值指示当前行的嵌套深度。
FieldCount	在派生类中重写时，获取当前行中的列数。
HasRows	在派生类中重写时，获取一个值，该值指示此 DbDataReader 是否包含一个或多个行。
IsClosed	在派生类中重写时，获取一个值，该值指示是否关闭 DbDataReader。
Item[Int32]	在派生类中重写时，获取指定列的值作为 Object的实例。
Item[String]	在派生类中重写时，获取指定列的值作为 Object的实例。
RecordsAffected	在派生类中重写时，获取通过执行 SQL 语句更改、插入或删除的行数。
VisibleFieldCount	获取未隐藏的 DbDataReader 中的字段数。

方法

Close()	关闭 DbDataReader 对象。
CloseAsync()	异步关闭 DbDataReader 对象。
CreateObjRef(Type)	创建一个对象，其中包含生成用于与远程对象通信的代理所需的所有相关信息。 (继承自 MarshalByRefObject)
Dispose()	释放 DbDataReader 类的当前实例使用的所有资源。
Dispose(Boolean)	释放 DbDataReader 使用的非托管资源，并选择性地释放托管资源。
DisposeAsync()	异步释放 DbDataReader 类的当前实例使用的所有资源。
Equals(Object)	确定指定的对象是否等于当前对象。 (继承自 Object)
GetBoolean(Int32)	在派生类中重写时，获取指定列的值作为布尔值。
GetByte(Int32)	在派生类中重写时，获取指定列的值作为字节。
GetBytes(Int32, Int64, Byte[], Int32, Int32)	在派生类中重写时，从指定索引处开始的指定列读取指定的字节数，并将其写入从缓冲区中的指定位置开始的缓冲区。
GetChar(Int32)	在派生类中重写时，获取指定列的值作为单个字符。
GetChars(Int32, Int64, Char[], Int32, Int32)	在派生类中重写时，从从指定索引处开始的指定列读取指定数目的字符，并将其写入从指定位置开始的缓冲区。
GetColumnSchemaAsync(CancellationToken)	这是 GetColumnSchema(DbDataReader)的异步版本。 提供程序应使用适当的实现替代。 可以选择遵守 cancellationToken。 默认实现调用同步 GetColumnSchema(DbDataReader) 调用并返回已完成的任务。 如果已通过已取消 cancellationToken，则默认实现将返回已取消的任务。 GetColumnSchema(DbDataReader) 引发的异常将通过返回的任务异常属性进行通信。
GetData(Int32)	返回所请求列的嵌套数据读取器。
GetDataTypeName(Int32)	在派生类中重写时，获取指定列的数据类型的名称。
GetDateTime(Int32)	在派生类中重写时，获取指定列的值作为 DateTime 对象。
GetDbDataReader(Int32)	为请求的列序号返回一个 DbDataReader 对象，该对象可以使用提供程序特定的实现重写。
GetDecimal(Int32)	在派生类中重写时，获取指定列的值作为 Decimal。
GetDouble(Int32)	在派生类中重写时，获取指定列的值作为双精度浮点数。
GetEnumerator()	在派生类中重写时，返回可用于循环访问数据读取器中的行的枚举数。
GetFieldType(Int32)	在派生类中重写时，获取指定列的数据类型。
GetFieldValue<T>(Int32)	获取指定列的值作为请求的类型。
GetFieldValueAsync<T>(Int32)	以异步方式获取指定列的值作为请求的类型。
GetFieldValueAsync<T>(Int32, CancellationToken)	以异步方式获取指定列的值作为请求的类型。
GetFloat(Int32)	在派生类中重写时，获取指定列的值作为单精度浮点数。
GetGuid(Int32)	在派生类中重写时，获取指定列的值作为全局唯一标识符（GUID）。
GetHashCode()	用作默认哈希函数。 (继承自 Object)
GetInt16(Int32)	在派生类中重写时，获取指定列的值作为 16 位有符号整数。
GetInt32(Int32)	在派生类中重写时，获取指定列的值作为 32 位有符号整数。
GetInt64(Int32)	在派生类中重写时，获取指定列的值作为 64 位带符号整数。
GetLifetimeService()	已过时. 检索控制此实例的生存期策略的当前生存期服务对象。 (继承自 MarshalByRefObject)
GetName(Int32)	在派生类中重写时，获取列的名称，给定从零开始的列序号。
GetOrdinal(String)	在派生类中重写时，获取给定列名称的列序号。
GetProviderSpecificFieldType(Int32)	获取指定列的提供程序特定类型。
GetProviderSpecificValue(Int32)	获取作为提供程序特定类型的实例的指定列的值。
GetProviderSpecificValues(Object[])	获取当前行的集合中所有特定于提供程序的属性列。
GetSchemaTable()	返回描述 DbDataReader的列元数据的 DataTable。 如果执行的命令未返回结果集，或在 NextResult() 返回 false之后，则返回 null。
GetSchemaTableAsync(CancellationToken)	这是 GetSchemaTable()的异步版本。 提供程序应使用适当的实现替代。 可以选择遵守 cancellationToken。 默认实现调用同步 GetSchemaTable() 调用并返回已完成的任务。 如果已通过已取消 cancellationToken，则默认实现将返回已取消的任务。 GetSchemaTable() 引发的异常将通过返回的任务异常属性进行通信。
GetStream(Int32)	获取从指定列检索数据的流。
GetString(Int32)	在派生类中重写时，获取指定列的值作为 String的实例。
GetTextReader(Int32)	获取从列检索数据的文本读取器。
GetType()	获取当前实例的 Type。 (继承自 Object)
GetValue(Int32)	在派生类中重写时，获取指定列的值作为 Object的实例。
GetValues(Object[])	在派生类中重写时，使用当前行的列值填充对象的数组。
InitializeLifetimeService()	已过时. 获取生存期服务对象来控制此实例的生存期策略。 (继承自 MarshalByRefObject)
IsDBNull(Int32)	在派生类中重写时，获取一个值，该值指示列是否包含不存在或缺失的值。
IsDBNullAsync(Int32)	异步获取一个值，该值指示列是包含不存在值还是缺失值。
IsDBNullAsync(Int32, CancellationToken)	异步获取一个值，该值指示列是包含不存在值还是缺失值。
MemberwiseClone()	创建当前 Object的浅表副本。 (继承自 Object)
MemberwiseClone(Boolean)	创建当前 MarshalByRefObject 对象的浅表副本。 (继承自 MarshalByRefObject)
NextResult()	在派生类中重写时，读取器在读取一批语句的结果时将读取器提升到下一个结果。
NextResultAsync()	读取一批语句的结果时，异步将读取器提升到下一个结果。
NextResultAsync(CancellationToken)	读取一批语句的结果时，异步将读取器提升到下一个结果。
Read()	在派生类中重写时，将读取器前进到结果集中的下一条记录。
ReadAsync()	异步将读取器前进到结果集中的下一条记录。
ReadAsync(CancellationToken)	异步将读取器前进到结果集中的下一条记录。
ToString()	返回一个表示当前对象的字符串。 (继承自 Object)

显式接口实现

IDataRecord.GetData(Int32)

有关此成员的说明，请参阅 GetData(Int32)。

扩展方法

CanGetColumnSchema(DbDataReader)	获取一个值，该值指示 DbDataReader 是否可以获取列架构。
GetColumnSchema(DbDataReader)	获取 DbDataReader的列架构（DbColumn 集合）。
GetBoolean(DbDataReader, String)	获取指定列的值作为布尔值。
GetByte(DbDataReader, String)	获取指定列作为字节的值。
GetBytes(DbDataReader, String, Int64, Byte[], Int32, Int32)	从指定索引处开始的指定列中读取指定的字节数，并将其写入缓冲区中从指定位置开始的缓冲区。
GetChar(DbDataReader, String)	获取指定列的值作为单个字符。
GetChars(DbDataReader, String, Int64, Char[], Int32, Int32)	从指定索引处开始的指定列读取指定数目的字符，并将其写入从指定位置开始的缓冲区。
GetData(DbDataReader, String)	返回所请求列的嵌套数据读取器。
GetDataTypeName(DbDataReader, String)	获取指定列的数据类型的名称。
GetDateTime(DbDataReader, String)	获取作为 DateTime 对象的指定列的值。
GetDecimal(DbDataReader, String)	获取指定列作为 Decimal的值。
GetDouble(DbDataReader, String)	获取指定列的值作为双精度浮点数。
GetFieldType(DbDataReader, String)	获取指定列的数据类型。
GetFieldValue<T>(DbDataReader, String)	获取指定列的值作为请求的类型。
GetFieldValueAsync<T>(DbDataReader, String, CancellationToken)	以异步方式获取指定列的值作为请求的类型。
GetFloat(DbDataReader, String)	获取指定列的值作为单精度浮点数。
GetGuid(DbDataReader, String)	获取指定列的值作为全局唯一标识符（GUID）。
GetInt16(DbDataReader, String)	获取指定列作为 16 位有符号整数的值。
GetInt32(DbDataReader, String)	获取指定列作为 32 位有符号整数的值。
GetInt64(DbDataReader, String)	获取指定列的值作为 64 位有符号整数。
GetProviderSpecificFieldType(DbDataReader, String)	获取指定列的提供程序特定类型。
GetProviderSpecificValue(DbDataReader, String)	获取作为提供程序特定类型的实例的指定列的值。
GetStream(DbDataReader, String)	获取从指定列检索数据的流。
GetString(DbDataReader, String)	获取指定列作为 String实例的值。
GetTextReader(DbDataReader, String)	获取从列检索数据的文本读取器。
GetValue(DbDataReader, String)	获取指定列作为 Object实例的值。
IsDBNull(DbDataReader, String)	获取一个值，该值指示列是包含不存在值还是缺失值。
IsDBNullAsync(DbDataReader, String, CancellationToken)	异步获取一个值，该值指示列是包含不存在值还是缺失值。
Cast<TResult>(IEnumerable)	将 IEnumerable 的元素强制转换为指定类型。
OfType<TResult>(IEnumerable)	根据指定类型筛选 IEnumerable 的元素。
AsParallel(IEnumerable)	启用查询的并行化。
AsQueryable(IEnumerable)	将 IEnumerable 转换为 IQueryable。
ConfigureAwait(IAsyncDisposable, Boolean)	配置如何执行从异步可释放项返回的任务的 await。

另请参阅

• DbProviderFactories （ADO.NET）
• ADO.NET 概述