DbDataReader 類別

定義

從資料來源讀取順向的資料流。

public ref class DbDataReader abstract : IDisposable, System::Collections::IEnumerable
public ref class DbDataReader abstract : MarshalByRefObject, IAsyncDisposable, IDisposable, System::Collections::IEnumerable, System::Data::IDataReader
public ref class DbDataReader abstract : IDisposable, System::Collections::IEnumerable, System::Data::IDataReader
public ref class DbDataReader abstract : MarshalByRefObject, IDisposable, System::Collections::IEnumerable, System::Data::IDataReader
public ref class DbDataReader abstract : MarshalByRefObject, System::Collections::IEnumerable, System::Data::IDataReader
public ref class DbDataReader abstract : MarshalByRefObject, IAsyncDisposable, System::Collections::IEnumerable, System::Data::IDataReader
public abstract class DbDataReader : IDisposable, System.Collections.IEnumerable
public abstract class DbDataReader : MarshalByRefObject, IAsyncDisposable, IDisposable, System.Collections.IEnumerable, System.Data.IDataReader
public abstract class DbDataReader : IDisposable, System.Collections.IEnumerable, System.Data.IDataReader
public abstract class DbDataReader : MarshalByRefObject, IDisposable, System.Collections.IEnumerable, System.Data.IDataReader
public abstract class DbDataReader : MarshalByRefObject, System.Collections.IEnumerable, System.Data.IDataReader
public abstract class DbDataReader : MarshalByRefObject, IAsyncDisposable, System.Collections.IEnumerable, System.Data.IDataReader
type DbDataReader = class
    interface IEnumerable
    interface IDisposable
type DbDataReader = class
    inherit MarshalByRefObject
    interface IEnumerable
    interface IDataReader
    interface IDataRecord
    interface IDisposable
    interface IAsyncDisposable
type DbDataReader = class
    interface IEnumerable
    interface IDataReader
    interface IDataRecord
    interface IDisposable
type DbDataReader = class
    inherit MarshalByRefObject
    interface IEnumerable
    interface IDataReader
    interface IDataRecord
    interface IDisposable
type DbDataReader = class
    inherit MarshalByRefObject
    interface IDataReader
    interface IDisposable
    interface IDataRecord
    interface IEnumerable
type DbDataReader = class
    inherit MarshalByRefObject
    interface IDataReader
    interface IEnumerable
    interface IDisposable
    interface IDataRecord
Public MustInherit Class DbDataReader
Implements IDisposable, IEnumerable
Public MustInherit Class DbDataReader
Inherits MarshalByRefObject
Implements IAsyncDisposable, IDataReader, IDisposable, IEnumerable
Public MustInherit Class DbDataReader
Implements IDataReader, IDisposable, IEnumerable
Public MustInherit Class DbDataReader
Inherits MarshalByRefObject
Implements IDataReader, IDisposable, IEnumerable
Public MustInherit Class DbDataReader
Inherits MarshalByRefObject
Implements IDataReader, IEnumerable
Public MustInherit Class DbDataReader
Inherits MarshalByRefObject
Implements IAsyncDisposable, IDataReader, IEnumerable
繼承
DbDataReader
繼承
DbDataReader
衍生
實作

建構函式

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 物件,可使用提供者特定的實作 (Implementation) 覆寫。

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()
已過時。

擷取控制這個執行個體存留期 (Lifetime) 原則的目前存留期服務物件。

(繼承來源 MarshalByRefObject)
GetName(Int32)

在衍生類別中覆寫時,取得資料行序數從零開始的資料行名稱。

GetOrdinal(String)

在衍生類別中覆寫時,取得具有資料行名稱的資料行序數。

GetProviderSpecificFieldType(Int32)

取得指定資料行的提供者特定類型。

GetProviderSpecificValue(Int32)

取得所指定資料行值作為提供者特定類型的執行個體。

GetProviderSpecificValues(Object[])

為目前的資料列在集合中取得所有提供者特定的屬性資料行。

GetSchemaTable()

傳回 DataTable,以描述 DbDataReader 的資料行中繼資料。 null如果執行的命令未傳回任何結果集,或傳回 之後 NextResult() ,則傳 false 回 。

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)

明確介面實作

IDataReader.Close()

如需這個成員的說明,請參閱 Close()

IDataReader.GetSchemaTable()

如需這個成員的說明,請參閱 GetSchemaTable()

IDataRecord.GetData(Int32)

如需這個成員的說明,請參閱 GetData(Int32)

擴充方法

CanGetColumnSchema(DbDataReader)

取得值,指出 DbDataReader 是否可取得資料行結構描述。

GetColumnSchema(DbDataReader)

取得 DbDataReader 的資料行結構描述 (DbColumn 集合)。

GetBoolean(DbDataReader, String)

取得指定之資料行的值做為布林值 (Boolean)。

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 位元帶正負號的整數 (Signed Integer)。

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。

適用於

另請參閱