OleDbDataReader クラス

定義

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

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

次の例では、 、 OleDbConnectionOleDbCommandおよび を作成します OleDbDataReader。 この例では、データを読み取り、コンソールに書き込みます。 最後に、 と を閉じますOleDbDataReaderOleDbConnection

public static void ReadData(string connectionString, string queryString)
{
    using (OleDbConnection connection = new OleDbConnection(connectionString))
    {
        OleDbCommand command = new OleDbCommand(queryString, connection);

        connection.Open();
        OleDbDataReader reader = command.ExecuteReader();

        while (reader.Read())
        {
            Console.WriteLine(reader[0].ToString());
        }
        reader.Close();
    }
}
Public Sub ReadData(ByVal connectionString As String, _
    ByVal queryString As String)
    Using connection As New OleDbConnection(connectionString)
        Dim command As New OleDbCommand(queryString, connection)

        connection.Open()

        Dim reader As OleDbDataReader = command.ExecuteReader()
        While reader.Read()
            Console.WriteLine(reader(0).ToString())
        End While
        reader.Close()
    End Using
End Sub

注釈

OleDbDataReader作成するには、コンストラクターを ExecuteReader 直接使用するのではなく、 オブジェクトの OleDbCommand メソッドを呼び出す必要があります。

を閉じる前に、 OleDbConnectionまず オブジェクトを OleDbDataReader 閉じます。 オブジェクトを再利用OleDbCommandするOleDbDataReader場合は、オブジェクトを閉じる必要もあります。たとえば、 を呼び出Closeすまで出力パラメーターを取得することはできません。

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

IsClosed が閉じた後に呼び出すことができるプロパティは、RecordsAffectedOleDbDataReader だけです。 がRecordsAffected存在する間OleDbDataReaderは プロパティにアクセスできますが、正確な戻り値を保証するために、 のRecordsAffected値を返す前に 常に を呼び出Closeしてください。

プロパティ

Depth

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

FieldCount

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

HasRows

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

IsClosed

データ リーダーが閉じているかどうかを示します。

Item[Int32]

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

Item[String]

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

RecordsAffected

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

VisibleFieldCount

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

メソッド

Close()

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

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)

要求された列の序数の OleDbDataReader オブジェクトを返します。

GetDataTypeName(Int32)

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

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 の列メタデータを記述する OleDbDataReader を返します。

GetSchemaTableAsync(CancellationToken)

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

(継承元 DbDataReader)
GetStream(Int32)

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

(継承元 DbDataReader)
GetString(Int32)

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

GetTextReader(Int32)

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

(継承元 DbDataReader)
GetTimeSpan(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 ステートメントの結果を読み取っているときに、次の結果にデータ リーダーを進めます。

NextResultAsync()

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

(継承元 DbDataReader)
NextResultAsync(CancellationToken)

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

(継承元 DbDataReader)
Read()

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

ReadAsync()

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

(継承元 DbDataReader)
ReadAsync(CancellationToken)

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

(継承元 DbDataReader)
ToString()

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

(継承元 Object)

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

IDataRecord.GetData(Int32)

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

IDataRecord.GetData(Int32)

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

(継承元 DbDataReader)
IDisposable.Dispose()

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

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

IEnumerable.GetEnumerator()

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

拡張メソッド

CanGetColumnSchema(DbDataReader)

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

GetColumnSchema(DbDataReader)

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

Cast<TResult>(IEnumerable)

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

OfType<TResult>(IEnumerable)

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

AsParallel(IEnumerable)

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

AsQueryable(IEnumerable)

IEnumerableIQueryable に変換します。

適用対象

こちらもご覧ください