OleDbDataReader クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
データ ソースからデータ行の前方専用ストリームを読み取る方法を提供します。 このクラスは継承できません。
public ref class OleDbDataReader sealed : System::Data::Common::DbDataReaderpublic ref class OleDbDataReader sealed : MarshalByRefObject, IDisposable, System::Collections::IEnumerable, System::Data::IDataReaderpublic sealed class OleDbDataReader : System.Data.Common.DbDataReaderpublic sealed class OleDbDataReader : MarshalByRefObject, IDisposable, System.Collections.IEnumerable, System.Data.IDataReadertype OleDbDataReader = class
inherit DbDataReadertype OleDbDataReader = class
inherit MarshalByRefObject
interface IDataReader
interface IDisposable
interface IDataRecord
interface IEnumerablePublic NotInheritable Class OleDbDataReader
Inherits DbDataReaderPublic NotInheritable Class OleDbDataReader
Inherits MarshalByRefObject
Implements IDataReader, IDisposable, IEnumerable- 継承
- 継承
- 実装
例
次の例では、OleDbConnection、OleDbCommand、および OleDbDataReaderを作成します。 この例では、データを読み取り、コンソールに書き出します。 最後に、OleDbDataReader を閉じ、OleDbConnectionを閉じます。
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を作成するには、コンストラクターを直接使用するのではなく、OleDbCommand オブジェクトの ExecuteReader メソッドを呼び出す必要があります。
OleDbConnectionを閉じる前に、まず OleDbDataReader オブジェクトを閉じます。 OleDbCommand オブジェクトを再利用する場合は、OleDbDataReader オブジェクトも閉じる必要があります。たとえば、Closeを呼び出すまで出力パラメーターを取得することはできません。
データの読み取り中に別のプロセスまたはスレッドによって結果セットに加えられた変更は、OleDbDataReaderのユーザーに表示される場合があります。 ただし、正確な動作はタイミングに依存します。
IsClosed と RecordsAffected は、OleDbDataReader を閉じた後に呼び出すことができる唯一のプロパティです。 OleDbDataReader が存在する間は、RecordsAffected プロパティにアクセスできますが、正確な戻り値を保証するために、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) |
指定した列の値をブール値として取得します。 |
| GetByte(Int32) |
指定した列の値をバイトとして取得します。 |
| GetBytes(Int32, Int64, Byte[], Int32, Int32) |
指定したバッファー オフセットから始まる配列として、指定した列オフセットからバッファーにバイト ストリームを読み取ります。 |
| GetChar(Int32) |
指定した列の値を文字として取得します。 |
| GetChars(Int32, Int64, Char[], Int32, Int32) |
指定されたバッファー オフセットから始まる配列として、指定した列オフセットからバッファーに文字のストリームを読み取ります。 |
| GetColumnSchemaAsync(CancellationToken) |
これは、GetColumnSchema(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() |
OleDbDataReaderの列メタデータを記述する DataTable を返します。 |
| GetSchemaTableAsync(CancellationToken) |
これは、GetSchemaTable()の非同期バージョンです。
プロバイダーは、適切な実装でオーバーライドする必要があります。
必要に応じて、 |
| 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() |
コレクションを反復処理する列挙子を返します。 |
拡張メソッド
適用対象
こちらもご覧ください
.NET