OdbcDataReader クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
データ ソースからデータ行の前方向ストリームを読み取る方法を提供します。 このクラスは継承できません。
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
- 継承
- 継承
- 実装
例
次の例では、 、 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 に 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) の非同期バージョンです。
プロバイダーは、適切な実装でオーバーライドする必要があります。
必要に応じて、 |
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() の非同期バージョンです。
プロバイダーは、適切な実装でオーバーライドする必要があります。
必要に応じて、 |
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 は製品インフラストラクチャをサポートします。コードから直接使用するものではありません。 コレクションを反復処理する列挙子を返します。 |
拡張メソッド
適用対象
こちらもご覧ください
.NET
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示