OleDbDataReader クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
データ ソースからデータ行の前方向ストリームを読み取る方法を提供します。 このクラスは継承できません。
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
- 継承
- 継承
- 実装
例
次の例では、 、 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作成するには、コンストラクターを ExecuteReader 直接使用するのではなく、 オブジェクトの OleDbCommand メソッドを呼び出す必要があります。
を閉じる前に、 OleDbConnectionまず オブジェクトを OleDbDataReader 閉じます。 オブジェクトを再利用OleDbCommandするOleDbDataReader場合は、オブジェクトを閉じる必要もあります。たとえば、 を呼び出Closeすまで出力パラメーターを取得することはできません。
データが読み取られている間に別のプロセスまたはスレッドによって結果セットに加えられた変更は、OleDbDataReader のユーザーに表示される場合がありますが、 正確な動作は、タイミングに応じて変わります。
IsClosed が閉じた後に呼び出すことができるプロパティは、RecordsAffected と OleDbDataReader だけです。 が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) の非同期バージョンです。
プロバイダーは、適切な実装でオーバーライドする必要があります。
必要に応じて、 |
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() の非同期バージョンです。
プロバイダーは、適切な実装でオーバーライドする必要があります。
必要に応じて、 |
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
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示