OdbcDataReader 類別

定義

命名空間:

System.Data.Odbc

組件:

System.Data.Odbc.dll

套件:

System.Data.Odbc v8.0.0

來源:

OdbcDataReader.cs

提供自資料來源讀取順向資料流的資料列的方法。 此類別無法獲得繼承。

public ref class OdbcDataReader sealed : System::Data::Common::DbDataReader

public sealed class OdbcDataReader : System.Data.Common.DbDataReader

type OdbcDataReader = class
    inherit DbDataReader

Public NotInheritable Class OdbcDataReader
Inherits DbDataReader

繼承

Object

DbDataReader

OdbcDataReader

範例

下列範例會建立 OdbcConnection 、、 OdbcCommand 和 OdbcDataReader 。 此範例會讀取資料，並將它寫出主控台。 最後，此範例會 OdbcDataReader 關閉 ，然後 OdbcConnection 關閉 。

public static void ReadData(string connectionString)
{
    string queryString = "SELECT DISTINCT CustomerID FROM Orders";

    using (OdbcConnection connection = new OdbcConnection(connectionString))
    {
        OdbcCommand command = new OdbcCommand(queryString, connection);

        connection.Open();

        // Execute the DataReader and access the data.
        OdbcDataReader reader = command.ExecuteReader();
        while (reader.Read())
        {
            Console.WriteLine("CustomerID={0}", reader[0]);
        }

        // Call Close when done reading.
        reader.Close();
    }
}

Public Sub ReadData(ByVal connectionString As String)
    Dim queryString As String = "SELECT DISTINCT CustomerID FROM Orders"

    Using connection As New OdbcConnection(connectionString)
        Dim command As New OdbcCommand(queryString, connection)

        connection.Open()

        Dim reader As OdbcDataReader = command.ExecuteReader()

        While reader.Read()
            Console.WriteLine("CustomerID={0}", reader(0).ToString)
        End While

        ' Call Close when done reading.
        reader.Close()
    End Using
End Sub

備註

若要建立 OdbcDataReader ，您必須呼叫 ExecuteReader 物件的 方法 OdbcCommand ，而不是直接使用建構函式。

OdbcDataReader在使用 時，相關聯的 OdbcConnection 正在忙碌中提供 OdbcDataReader ，而且除了關閉其他作業之外，也無法執行 OdbcConnection 其他作業。 這是在呼叫 的 OdbcDataReader 方法之前 Close 的情況。 例如，在呼叫 Close 之後，您才能擷取輸出參數。

正在讀取資料時，OdbcDataReader 使用者會看到另一個處理序或執行緒對結果集所進行的變更。 不過，精確的行為同時取決於驅動程式和計時。

IsClosed 與 RecordsAffected 是在關閉 OdbcDataReader 後唯一可呼叫的屬性。 有時候，您必須先呼叫 Close ，才能呼叫 RecordsAffected 。

屬性

Depth	取得值，表示目前資料列的巢狀深度。
FieldCount	取得目前資料列中的資料行數目。
HasRows	取得值，指出 OdbcDataReader 是否包含一個或多個資料列。
IsClosed	指出 OdbcDataReader 是否關閉。
Item[Int32]	提供資料行序數，取得使用原生格式的指定資料行值。
Item[String]	提供資料行名稱，取得使用原生格式的指定資料行值。
RecordsAffected	取得因執行 SQL 陳述式所變更、插入或刪除的資料列數目。
VisibleFieldCount	取得 DbDataReader 中沒有隱藏的欄位數。 (繼承來源 DbDataReader)

方法

Close()	關閉 OdbcDataReader 物件。
CloseAsync()	非同步關閉 DbDataReader 物件。 (繼承來源 DbDataReader)
Dispose()	釋放 DbDataReader 類別目前的執行個體所使用的全部資源。 (繼承來源 DbDataReader)
Dispose(Boolean)	釋放 DbDataReader 所使用的 Unmanaged 資源，並選擇性地釋放 Managed 資源。 (繼承來源 DbDataReader)
DisposeAsync()	以非同步方式將 DbDataReader 類別的目前執行個體所使用所有資源釋出。 (繼承來源 DbDataReader)
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetBoolean(Int32)	取得指定之資料行的值做為布林值 (Boolean)。
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) 擲回的例外狀況會透過傳回的工作例外狀況屬性來傳送。 (繼承來源 DbDataReader)
GetData(Int32)	傳回所要求資料行的巢狀資料讀取器。 (繼承來源 DbDataReader)
GetDataTypeName(Int32)	取得來源資料型別的名稱。
GetDate(Int32)	取得指定之資料行的值做為 DateTime 物件。
GetDateTime(Int32)	取得指定之資料行的值做為 DateTime 物件。
GetDbDataReader(Int32)	傳回所要求資料行序數的 DbDataReader 物件，可使用提供者特定的實作 (Implementation) 覆寫。 (繼承來源 DbDataReader)
GetDecimal(Int32)	取得指定之資料行的值做為 Decimal 物件。
GetDouble(Int32)	取得指定之資料行的值做為雙精度浮點數。
GetEnumerator()	傳回 IEnumerator，可用來逐一查看資料讀取器中的資料列。
GetFieldType(Int32)	取得 Type，即是物件的資料型別。
GetFieldValue<T>(Int32)	取得所指定資料行值作為要求類型。 (繼承來源 DbDataReader)
GetFieldValueAsync<T>(Int32)	以非同步方式取得所指定資料行的值作為要求類型。 (繼承來源 DbDataReader)
GetFieldValueAsync<T>(Int32, CancellationToken)	以非同步方式取得所指定資料行的值作為要求類型。 (繼承來源 DbDataReader)
GetFloat(Int32)	取得指定資料行的值做為單精確度浮點數。
GetGuid(Int32)	從指定的資料行取得通用唯一識別碼 (GUID) 形式的值。
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetInt16(Int32)	取得指定資料行的值做為 16 位元帶正負號的整數。
GetInt32(Int32)	取得指定資料行的值作為 32 位元帶正負號的整數。
GetInt64(Int32)	取得指定資料行的值做為 64 位元帶正負號的整數 (Signed Integer)。
GetName(Int32)	取得指定資料行的名稱。
GetOrdinal(String)	提供資料行的名稱，取得資料行序數。
GetProviderSpecificFieldType(Int32)	取得指定資料行的提供者特定類型。 (繼承來源 DbDataReader)
GetProviderSpecificValue(Int32)	取得所指定資料行值作為提供者特定類型的執行個體。 (繼承來源 DbDataReader)
GetProviderSpecificValues(Object[])	為目前的資料列在集合中取得所有提供者特定的屬性資料行。 (繼承來源 DbDataReader)
GetSchemaTable()	傳回 DataTable，以描述 OdbcDataReader 的資料行中繼資料。
GetSchemaTableAsync(CancellationToken)	這是 GetSchemaTable() 的非同步版本。 提供者應該覆寫為適當的實作。 您可以選擇性地接受 cancellationToken。 預設實作會叫用同步GetSchemaTable()呼叫並傳回完成的工作。 如果傳遞一個已經被取消的 cancellationToken，預設實作會傳回已取消的工作。 GetSchemaTable() 擲回的例外狀況會透過傳回的工作例外狀況屬性來傳送。 (繼承來源 DbDataReader)
GetStream(Int32)	取得資料流以從指定的資料行擷取資料。 (繼承來源 DbDataReader)
GetString(Int32)	取得指定的資料行值做為 String。
GetTextReader(Int32)	取得文字讀取器以從資料行擷取資料。 (繼承來源 DbDataReader)
GetTime(Int32)	取得指定之資料行的值做為 TimeSpan 物件。
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
GetValue(Int32)	取得使用原生格式的指定序數的資料行值。
GetValues(Object[])	使用目前資料列的資料行值填入物件陣列。
IsDBNull(Int32)	取得值，這個值表示資料行是否包含不存在或遺漏的值。
IsDBNullAsync(Int32)	以非同步方式取得值，指出資料行是否包含不存在或遺漏的值。 (繼承來源 DbDataReader)
IsDBNullAsync(Int32, CancellationToken)	以非同步方式取得值，指出資料行是否包含不存在或遺漏的值。 (繼承來源 DbDataReader)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
NextResult()	讀取批次 SQL 陳述式的結果時，將 OdbcDataReader 前進到下一個結果。
NextResultAsync()	在讀取陳述式批次的結果時，以非同步方式將讀取器向前移到下一個結果。 (繼承來源 DbDataReader)
NextResultAsync(CancellationToken)	在讀取陳述式批次的結果時，以非同步方式將讀取器向前移到下一個結果。 (繼承來源 DbDataReader)
Read()	將 OdbcDataReader 推進到下一筆記錄。
ReadAsync()	以非同步方式將讀取器向前移到結果集中的下一筆記錄。 (繼承來源 DbDataReader)
ReadAsync(CancellationToken)	以非同步方式將讀取器向前移到結果集中的下一筆記錄。 (繼承來源 DbDataReader)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)

擴充方法

另請參閱

• DataAdapter 和 DataReader