OdbcDataReader クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
データ ソースからデータ行の前方専用ストリームを読み取る方法を提供します。 このクラスは継承できません。
public ref class OdbcDataReader sealed : System::Data::Common::DbDataReaderpublic ref class OdbcDataReader sealed : MarshalByRefObject, IDisposable, System::Collections::IEnumerable, System::Data::IDataReaderpublic sealed class OdbcDataReader : System.Data.Common.DbDataReaderpublic sealed class OdbcDataReader : MarshalByRefObject, IDisposable, System.Collections.IEnumerable, System.Data.IDataReadertype OdbcDataReader = class
inherit DbDataReadertype OdbcDataReader = class
inherit MarshalByRefObject
interface IDataReader
interface IDataRecord
interface IDisposable
interface IEnumerablePublic NotInheritable Class OdbcDataReader
Inherits DbDataReaderPublic 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を作成するには、コンストラクターを直接使用するのではなく、OdbcCommand オブジェクトの ExecuteReader メソッドを呼び出す必要があります。
OdbcDataReader が使用されている間、関連付けられている OdbcConnection は OdbcDataReaderを処理中であり、OdbcConnection に対して閉じる以外の操作は実行できません。 これは、OdbcDataReader の Close メソッドが呼び出されるまでのケースです。 たとえば、Closeを呼び出すまで出力パラメーターを取得することはできません。
データの読み取り中に別のプロセスまたはスレッドによって結果セットに加えられた変更は、OdbcDataReaderのユーザーに表示される場合があります。 ただし、正確な動作はドライバーとタイミングの両方に依存します。
IsClosed と RecordsAffected は、OdbcDataReader を閉じた後に呼び出すことができる唯一のプロパティです。 場合によっては、RecordsAffectedを呼び出す前に Close を呼び出す必要があります。
プロパティ
| 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) |
指定した列の値をブール値として取得します。 |
| 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() |
OdbcDataReaderの列メタデータを記述する DataTable を返します。 |
| 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