DbDataReader 類別

定義

命名空間:

System.Data.Common

組件:

System.Data.Common.dll

來源:

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)	建立物件，其中包含產生用來與遠端物件通訊之 Proxy 所需的所有相關信息。 (繼承來源 MarshalByRefObject)
Dispose()	釋放目前 DbDataReader 類別實例所使用的所有資源。
Dispose(Boolean)	釋放 DbDataReader 所使用的 Unmanaged 資源，並選擇性地釋放 Managed 資源。
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)	設定如何執行從異步可處置專案傳回的工作等候。

另請參閱

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