DbDataReader Class

定義

データ ソースから、前方参照専用の行のストリームを読み取ります。 Reads a forward-only stream of rows from a data source.

public abstract class DbDataReader : MarshalByRefObject, IDisposable, System.Collections.IEnumerable, System.Data.IDataReader
継承
派生
実装

コンストラクター

DbDataReader()

DbDataReader クラスの新しいインスタンスを初期化します。 Initializes a new instance of the DbDataReader class.

プロパティ

Depth

現在の行の入れ子の深さを示す値を取得します。 Gets a value indicating the depth of nesting for the current row.

FieldCount

現在の行の列の数を取得します。 Gets the number of columns in the current row.

HasRows

この DbDataReader に 1 つ以上の行が含まれているかどうかを示す値を取得します。 Gets a value that indicates whether this DbDataReader contains one or more rows.

IsClosed

DbDataReader が閉じているかどうかを示す値を取得します。 Gets a value indicating whether the DbDataReader is closed.

Item[Int32]

指定された列の値を Object のインスタンスとして取得します。 Gets the value of the specified column as an instance of Object.

Item[String]

指定された列の値を Object のインスタンスとして取得します。 Gets the value of the specified column as an instance of Object.

RecordsAffected

SQL ステートメントの実行によって変更、挿入、または削除された行の数を取得します。 Gets the number of rows changed, inserted, or deleted by execution of the SQL statement.

VisibleFieldCount

DbDataReader 内の表示フィールドの数を取得します。 Gets the number of fields in the DbDataReader that are not hidden.

方法

Close()

DbDataReader オブジェクトを閉じます。 Closes the DbDataReader object.

CreateObjRef(Type)

リモート オブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。 Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
Dispose()

DbDataReader クラスの現在のインスタンスによって使用されているすべてのリソースを解放します。 Releases all resources used by the current instance of the DbDataReader class.

Dispose(Boolean)

DbDataReader によって使用されているマネージド リソースを解放し、オプションでアンマネージド リソースも解放します。 Releases the managed resources used by the DbDataReader and optionally releases the unmanaged resources.

Equals(Object)

指定したオブジェクトが、現在のオブジェクトと等しいかどうかを判断します。 Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetBoolean(Int32)

指定された列の値を Boolean として取得します。 Gets the value of the specified column as a Boolean.

GetByte(Int32)

指定された列の値をバイトとして取得します。 Gets the value of the specified column as a byte.

GetBytes(Int32, Int64, Byte[], Int32, Int32)

指定した列の dataOffset で指定された位置から開始されるバイト ストリームを、バッファーの bufferOffset で指定された開始位置に読み込みます。 Reads a stream of bytes from the specified column, starting at location indicated by dataOffset, into the buffer, starting at the location indicated by bufferOffset.

GetChar(Int32)

指定された列の値を単一の文字として取得します。 Gets the value of the specified column as a single character.

GetChars(Int32, Int64, Char[], Int32, Int32)

指定した列の dataOffset で指定された位置から開始される文字ストリームを、バッファーの bufferOffset で指定された開始位置に読み込みます。 Reads a stream of characters from the specified column, starting at location indicated by dataOffset, into the buffer, starting at the location indicated by bufferOffset.

GetData(Int32)

要求された列の序数の DbDataReader オブジェクトを返します。 Returns a DbDataReader object for the requested column ordinal.

GetDataTypeName(Int32)

指定された列のデータ型の名前を取得します。 Gets name of the data type of the specified column.

GetDateTime(Int32)

指定された列の値を DateTime オブジェクトとして取得します。 Gets the value of the specified column as a DateTime object.

GetDbDataReader(Int32)

プロバイダー固有の実装でオーバーライドできる、要求された列序数に対応した DbDataReader オブジェクトを返します。 Returns a DbDataReader object for the requested column ordinal that can be overridden with a provider-specific implementation.

GetDecimal(Int32)

指定された列の値を Decimal オブジェクトとして取得します。 Gets the value of the specified column as a Decimal object.

GetDouble(Int32)

指定された列の値を倍精度浮動小数点値として取得します。 Gets the value of the specified column as a double-precision floating point number.

GetEnumerator()

データ リーダー内の行に対して反復処理を行うために使用できる IEnumerator を返します。 Returns an IEnumerator that can be used to iterate through the rows in the data reader.

GetFieldType(Int32)

指定された列のデータ型を取得します。 Gets the data type of the specified column.

GetFieldValue<T>(Int32)

指定された列の値を型として同期的に取得します。 Synchronously gets the value of the specified column as a type.

GetFieldValueAsync<T>(Int32)

指定された列の値を型として非同期的に取得します。 Asynchronously gets the value of the specified column as a type.

GetFieldValueAsync<T>(Int32, CancellationToken)

指定された列の値を型として非同期的に取得します。 Asynchronously gets the value of the specified column as a type.

GetFloat(Int32)

指定された列の値を単精度浮動小数点値として取得します。 Gets the value of the specified column as a single-precision floating point number.

GetGuid(Int32)

指定された列の値をグローバル一意識別子 (GUID) として取得します。 Gets the value of the specified column as a globally-unique identifier (GUID).

GetHashCode()

既定のハッシュ関数として機能します。 Serves as the default hash function.

(Inherited from Object)
GetInt16(Int32)

指定した列の値を 16 ビット符号付き整数として取得します。 Gets the value of the specified column as a 16-bit signed integer.

GetInt32(Int32)

指定された列の値を 32 ビット符号付き整数として取得します。 Gets the value of the specified column as a 32-bit signed integer.

GetInt64(Int32)

指定された列の値を 64 ビット符号付き整数として取得します。 Gets the value of the specified column as a 64-bit signed integer.

GetLifetimeService()

対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービス オブジェクトを取得します。 Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetName(Int32)

0 から始まる列序数で指定された列の値を取得します。 Gets the name of the column, given the zero-based column ordinal.

GetOrdinal(String)

名前で指定された列の列序数を取得します。 Gets the column ordinal given the name of the column.

GetProviderSpecificFieldType(Int32)

指定された列の、プロバイダー固有のフィールド型を返します。 Returns the provider-specific field type of the specified column.

GetProviderSpecificValue(Int32)

指定された列の値を Object のインスタンスとして取得します。 Gets the value of the specified column as an instance of Object.

GetProviderSpecificValues(Object[])

現在の行のコレクション内にあるプロバイダー固有の属性列をすべて取得します。 Gets all provider-specific attribute columns in the collection for the current row.

GetSchemaTable()

DataTable の列メタデータを記述する DbDataReader を返します。 Returns a DataTable that describes the column metadata of the DbDataReader.

GetStream(Int32)

Stream としてデータを取得します。 Retrieves data as a Stream.

GetString(Int32)

指定された列の値を String のインスタンスとして取得します。 Gets the value of the specified column as an instance of String.

GetTextReader(Int32)

TextReader としてデータを取得します。 Retrieves data as a TextReader.

GetType()

現在のインスタンスの Type を取得します。 Gets the Type of the current instance.

(Inherited from Object)
GetValue(Int32)

指定された列の値を Object のインスタンスとして取得します。 Gets the value of the specified column as an instance of Object.

GetValues(Object[])

オブジェクトの配列に現在行の列値を設定します。 Populates an array of objects with the column values of the current row.

InitializeLifetimeService()

このインスタンスの有効期間ポリシーを制御する有効期間サービス オブジェクトを取得します。 Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
IsDBNull(Int32)

存在しない値や欠落値が列に含まれているかどうかを示す値を取得します。 Gets a value that indicates whether the column contains nonexistent or missing values.

IsDBNullAsync(Int32)

列に格納されている値が存在しない値または欠損値かどうかを示す値を取得する IsDBNull(Int32) の非同期バージョン。 An asynchronous version of IsDBNull(Int32), which gets a value that indicates whether the column contains non-existent or missing values.

IsDBNullAsync(Int32, CancellationToken)

列に格納されている値が存在しない値または欠損値かどうかを示す値を取得する IsDBNull(Int32) の非同期バージョン。 An asynchronous version of IsDBNull(Int32), which gets a value that indicates whether the column contains non-existent or missing values. 必要に応じて、操作を取り消す必要があるという通知を送信します。 Optionally, sends a notification that operations should be cancelled.

MemberwiseClone()

現在の Object の簡易コピーを作成します。 Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean)

現在の MarshalByRefObject オブジェクトの簡易コピーを作成します。 Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
NextResult()

バッチ ステートメントの結果を読み取っているときに、次の結果にリーダーを進めます。 Advances the reader to the next result when reading the results of a batch of statements.

NextResultAsync()

バッチ ステートメントの結果を読み込むときに、リーダーを次の結果に進める NextResult() の非同期バージョン。 An asynchronous version of NextResult(), which advances the reader to the next result when reading the results of a batch of statements. CancellationToken.None を使用して、NextResultAsync(CancellationToken) を呼び出します。 Invokes NextResultAsync(CancellationToken) with CancellationToken.None.

NextResultAsync(CancellationToken)

これは NextResult() の非同期バージョンです。 This is the asynchronous version of NextResult(). プロバイダーは、適切な実装でオーバーライドする必要があります。 Providers should override with an appropriate implementation. オプションで cancellationToken を無視できます。 The cancellationToken may optionally be ignored. 既定の実装は NextResult() 同期メソッドを呼び出し、完了したタスクを返します。呼び出し元のスレッドはブロックされます。 The default implementation invokes the synchronous NextResult() method and returns a completed task, blocking the calling thread. 既定の実装は、既に取り消された cancellationToken を渡した場合、取り消されたタスクを返します。 The default implementation will return a cancelled task if passed an already cancelled cancellationToken. NextResult() によってスローされる例外は、返されたタスクの Exception プロパティを介して通信されます。 Exceptions thrown by NextResult() will be communicated via the returned Task Exception property. 返されたタスクが完了していないうちは、DbDataReader のオブジェクトの他のメソッドとプロパティを呼び出さないでください。 Other methods and properties of the DbDataReader object should not be invoked while the returned Task is not yet completed.

Read()

結果セット内の次のレコードにリーダーを進めます。 Advances the reader to the next record in a result set.

ReadAsync()

結果セットの次のレコードにリーダーを進める Read() の非同期バージョン。 An asynchronous version of Read(), which advances the reader to the next record in a result set. このメソッドは、CancellationToken.None で ReadAsync(CancellationToken) を呼び出します。 This method invokes ReadAsync(CancellationToken) with CancellationToken.None.

ReadAsync(CancellationToken)

これは Read() の非同期バージョンです。 This is the asynchronous version of Read(). プロバイダーは、適切な実装でオーバーライドする必要があります。 Providers should override with an appropriate implementation. オプションで cancellationToken を無視できます。 The cancellationToken may optionally be ignored. 既定の実装は Read() 同期メソッドを呼び出し、完了したタスクを返します。呼び出し元のスレッドはブロックされます。 The default implementation invokes the synchronous Read() method and returns a completed task, blocking the calling thread. 既定の実装は、既に取り消された cancellationToken を渡した場合、取り消されたタスクを返します。 The default implementation will return a cancelled task if passed an already cancelled cancellationToken. Read によってスローされる例外は、返されたタスクの Exception プロパティを介して通信されます。 Exceptions thrown by Read will be communicated via the returned Task Exception property. 返されたタスクが完了するまで DbDataReader オブジェクトの他のメソッドとプロパティを呼び出さないでください。 Do not invoke other methods and properties of the DbDataReader object until the returned Task is complete.

ToString()

現在のオブジェクトを表す文字列を返します。 Returns a string that represents the current object.

(Inherited from Object)

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

IDataReader.Close()
IDataReader.GetSchemaTable()
IDataRecord.GetData(Int32)

このメンバーの詳細については、「GetData(Int32)」をご覧ください。 For a description of this member, see GetData(Int32).

適用対象