OdbcDataReader クラス

定義

データ ソースからデータ行の前方向ストリームを読み取る方法を提供します。 このクラスは継承できません。

public ref class OdbcDataReader sealed : System::Data::Common::DbDataReader
public ref class OdbcDataReader sealed : MarshalByRefObject, IDisposable, System::Collections::IEnumerable, System::Data::IDataReader
public sealed class OdbcDataReader : System.Data.Common.DbDataReader
public sealed class OdbcDataReader : MarshalByRefObject, IDisposable, System.Collections.IEnumerable, System.Data.IDataReader
type OdbcDataReader = class
    inherit DbDataReader
type OdbcDataReader = class
    inherit MarshalByRefObject
    interface IDataReader
    interface IDataRecord
    interface IDisposable
    interface IEnumerable
Public NotInheritable Class OdbcDataReader
Inherits DbDataReader
Public NotInheritable Class OdbcDataReader
Inherits MarshalByRefObject
Implements IDataReader, IDisposable, IEnumerable
継承
OdbcDataReader
継承
継承
OdbcDataReader
実装

次の例では、 、 OdbcConnectionOdbcCommandおよび を作成します 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実行することはできません。 これは、 の メソッドOdbcDataReaderClose呼び出されるまでの場合です。 たとえば、 を呼び出 Closeすまで出力パラメーターを取得することはできません。

データが読み取られている間に別のプロセスまたはスレッドによって結果セットに加えられた変更は、OdbcDataReader のユーザーに表示される場合がありますが、 ただし、正確な動作はドライバーとタイミングの両方に依存します。

IsClosed が閉じた後に呼び出すことができるプロパティは、RecordsAffectedOdbcDataReader だけです。 場合によっては、 を呼び出す Close 前に を呼び出す RecordsAffected必要があります。

プロパティ

Depth

現在の行の入れ子の深さを示す値を取得します。

FieldCount

現在の行の列の数を取得します。

HasRows

OdbcDataReader に 1 行以上の行が格納されているかどうかを示す値を取得します。

IsClosed

OdbcDataReader が閉じているかどうかを示します。

Item[Int32]

列の序数によって指定した列の値をネイティブ形式で取得します。

Item[String]

列名によって指定した列の値をネイティブ形式で取得します。

RecordsAffected

SQL ステートメントの実行によって変更、挿入、または削除された行の数を取得します。

VisibleFieldCount

DbDataReader 内の表示フィールドの数を取得します。

(継承元 DbDataReader)

メソッド

Close()

OdbcDataReader オブジェクトを閉じます。

CloseAsync()

DbDataReader オブジェクトを非同期に閉じます。

(継承元 DbDataReader)
CreateObjRef(Type)

リモート オブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。

(継承元 MarshalByRefObject)
Dispose()

DbDataReader クラスの現在のインスタンスによって使用されているすべてのリソースを解放します。

(継承元 DbDataReader)
Dispose(Boolean)

DbDataReader によって使用されているアンマネージド リソースを解放し、オプションでマネージド リソースも解放します。

(継承元 DbDataReader)
DisposeAsync()

DbDataReader クラスの現在のインスタンスによって使用されているすべてのリソースを非同期で解放します。

(継承元 DbDataReader)
Equals(Object)

指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。

(継承元 Object)
Finalize()

オブジェクトがガベージ コレクションにより収集される前に、そのオブジェクトがリソースを解放し、その他のクリーンアップ操作を実行できるようにします。

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) によってスローされる例外は、返されたタスクの Exception プロパティを介して通信されます。

(継承元 DbDataReader)
GetData(Int32)

指定された列序数の IDataReader を返します。

GetData(Int32)

要求された列に対して、入れ子になったデータ リーダーを返します。

(継承元 DbDataReader)
GetDataTypeName(Int32)

ソース データ型名を取得します。

GetDate(Int32)

指定された列の値を DateTime オブジェクトとして取得します。

GetDateTime(Int32)

指定された列の値を DateTime オブジェクトとして取得します。

GetDbDataReader(Int32)

プロバイダー固有の実装でオーバーライドできる、要求された列序数に対応した DbDataReader オブジェクトを返します。

(継承元 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 ビット符号付き整数として取得します。

GetLifetimeService()
古い.

対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービス オブジェクトを取得します。

(継承元 MarshalByRefObject)
GetName(Int32)

指定した列の名前を取得します。

GetOrdinal(String)

列の名前を指定して、列の序数を取得します。

GetProviderSpecificFieldType(Int32)

指定された列のプロバイダー固有の型を取得します。

(継承元 DbDataReader)
GetProviderSpecificValue(Int32)

指定された列の値をプロバイダー固有の型のインスタンスとして取得します。

(継承元 DbDataReader)
GetProviderSpecificValues(Object[])

現在の行のコレクション内にあるプロバイダー固有の属性列をすべて取得します。

(継承元 DbDataReader)
GetSchemaTable()

DataTable の列メタデータを記述する OdbcDataReader を返します。

GetSchemaTableAsync(CancellationToken)

これは GetSchemaTable() の非同期バージョンです。 プロバイダーは、適切な実装でオーバーライドする必要があります。 必要に応じて、cancellationToken を優先できます。 既定の実装は同期 GetSchemaTable() コールを呼び出し、完了したタスクを返します。 既定の実装は、既に取り消された cancellationToken を渡した場合、取り消されたタスクを返します。 GetSchemaTable() によってスローされる例外は、返されたタスクの Exception プロパティを介して通信されます。

(継承元 DbDataReader)
GetStream(Int32)

指定された列からデータを取得する目的でストリームを取得します。

(継承元 DbDataReader)
GetString(Int32)

指定した列の値を String として取得します。

GetTextReader(Int32)

列からデータを取得する目的でテキスト リーダーを取得します。

(継承元 DbDataReader)
GetTime(Int32)

指定された列の値を TimeSpan オブジェクトとして取得します。

GetType()

現在のインスタンスの Type を取得します。

(継承元 Object)
GetValue(Int32)

指定した序数の列の値をネイティブ形式で取得します。

GetValues(Object[])

オブジェクトの配列に現在行の列値を設定します。

InitializeLifetimeService()
古い.

このインスタンスの有効期間ポリシーを制御する有効期間サービス オブジェクトを取得します。

(継承元 MarshalByRefObject)
IsDBNull(Int32)

存在しない値や欠落値が列に含まれているかどうかを示す値を取得します。

IsDBNullAsync(Int32)

列に格納されている値が存在しない値または欠損値かどうかを示す値を非同期で取得します。

(継承元 DbDataReader)
IsDBNullAsync(Int32, CancellationToken)

列に格納されている値が存在しない値または欠損値かどうかを示す値を非同期で取得します。

(継承元 DbDataReader)
MemberwiseClone()

現在の Object の簡易コピーを作成します。

(継承元 Object)
MemberwiseClone(Boolean)

現在の MarshalByRefObject オブジェクトの簡易コピーを作成します。

(継承元 MarshalByRefObject)
NextResult()

バッチ SQL ステートメントの結果を読み込むときに、OdbcDataReader を次の結果に進めます。

NextResultAsync()

バッチ ステートメントの結果を読み取っているときに、次の結果にリーダーを非同期で進めます。

(継承元 DbDataReader)
NextResultAsync(CancellationToken)

バッチ ステートメントの結果を読み取っているときに、次の結果にリーダーを非同期で進めます。

(継承元 DbDataReader)
Read()

OdbcDataReader を次のレコードに進めます。

ReadAsync()

結果セット内の次のレコードにリーダーを非同期で進めます。

(継承元 DbDataReader)
ReadAsync(CancellationToken)

結果セット内の次のレコードにリーダーを非同期で進めます。

(継承元 DbDataReader)
ToString()

現在のオブジェクトを表す文字列を返します。

(継承元 Object)

明示的なインターフェイスの実装

IDataRecord.GetData(Int32)

このメンバーの詳細については、「GetData(Int32)」をご覧ください。

(継承元 DbDataReader)
IDisposable.Dispose()

この API は製品インフラストラクチャをサポートします。コードから直接使用するものではありません。

OdbcDataReader クラスの現在のインスタンスによって使用されているすべてのリソースを解放します。

IEnumerable.GetEnumerator()

この API は製品インフラストラクチャをサポートします。コードから直接使用するものではありません。

コレクションを反復処理する列挙子を返します。

拡張メソッド

CanGetColumnSchema(DbDataReader)

DbDataReader が列スキーマを取得できるかどうかを示す値を取得します。

GetColumnSchema(DbDataReader)

DbDataReader 用に、列のスキーマ (DbColumn コレクション) を取得します。

Cast<TResult>(IEnumerable)

IEnumerable の要素を、指定した型にキャストします。

OfType<TResult>(IEnumerable)

指定された型に基づいて IEnumerable の要素をフィルター処理します。

AsParallel(IEnumerable)

クエリの並列化を有効にします。

AsQueryable(IEnumerable)

IEnumerableIQueryable に変換します。

適用対象

こちらもご覧ください