DbDataReader.GetFieldValueAsync Method

定義

指定された列の値を型として非同期的に取得します。 Asynchronously 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.

注釈

詳細については、次を参照してください。 SqlClient ストリーミング サポートします。For more information, see SqlClient Streaming Support.

GetFieldValueAsync<T>(Int32)

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

public System.Threading.Tasks.Task<T> GetFieldValueAsync<T> (int ordinal);
型パラメーター
T

返される値の型。 The type of the value to be returned.

パラメーター
ordinal
Int32

返される値の型。 The type of the value to be returned.

戻り値
Task<T>

返される値の型。 The type of the value to be returned.

例外

データの取得中、接続は破棄されるか、または閉じられます。 The connection drops or is closed during the data retrieval. DbDataReader は、データの取得時に閉じます。 The DbDataReader is closed during the data retrieval. 読み取ることのできるデータはありません (たとえば、最初の Read() は呼び出されなかったか、false を返しました)。 There is no data ready to be read (for example, the first Read() hasn't been called, or returned false). 以前に読み取られた列をシーケンシャル モードで読み取ろうとしました。 Tried to read a previously-read column in sequential mode. 非同期操作が進行中でした。 There was an asynchronous operation in progress. シーケンシャル モードで実行中、これはすべての Get* メソッドに適用されます。ストリームの読み取り中に呼び出すことができるためです。 This applies to all Get* methods when running in sequential mode, as they could be called while reading a stream.

存在しない列を読み取ろうとしています。 Trying to read a column that does not exist.

T がデータ ソースから返された型に一致しないか、キャストできません。 T doesn’t match the type returned by the data source or cannot be cast.

注釈

T 次の種類のいずれかを指定できます。T can be one of the following types:

ブール型Boolean ByteByte CharChar DateTimeDateTime
DateTimeOffsetDateTimeOffset Decimal (10 進数型)Decimal 倍精度浮動小数点型Double FloatFloat
GUIDGuid Int16Int16 Int32Int32 Int64Int64
StringString

詳細については、次を参照してください。 SqlClient ストリーミング サポートします。For more information, see SqlClient Streaming Support.

GetFieldValueAsync<T>(Int32, CancellationToken)

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

public virtual System.Threading.Tasks.Task<T> GetFieldValueAsync<T> (int ordinal, System.Threading.CancellationToken cancellationToken);
型パラメーター
T

返される値の型。 The type of the value to be returned.

パラメーター
ordinal
Int32

返される値の型。 The type of the value to be returned.

cancellationToken
CancellationToken

操作を取り消すことを示す通知を反映する取り消し命令。 The cancellation instruction, which propagates a notification that operations should be canceled. これは取り消しを保証しません。 This does not guarantee the cancellation. CancellationToken.None の設定は、このメソッドを GetFieldValueAsync<T>(Int32) と同じにします。 A setting of CancellationToken.None makes this method equivalent to GetFieldValueAsync<T>(Int32). 返されたタスクを取り消し済みとしてマークする必要があります。 The returned task must be marked as cancelled.

戻り値
Task<T>

返される値の型。 The type of the value to be returned.

例外

データの取得中、接続は破棄されるか、または閉じられます。 The connection drops or is closed during the data retrieval. DbDataReader は、データの取得時に閉じます。 The DbDataReader is closed during the data retrieval. 読み取ることのできるデータはありません (たとえば、最初の Read() は呼び出されなかったか、false を返しました)。 There is no data ready to be read (for example, the first Read() hasn't been called, or returned false). 以前に読み取られた列をシーケンシャル モードで読み取ろうとしました。 Tried to read a previously-read column in sequential mode. 非同期操作が進行中でした。 There was an asynchronous operation in progress. シーケンシャル モードで実行中、これはすべての Get* メソッドに適用されます。ストリームの読み取り中に呼び出すことができるためです。 This applies to all Get* methods when running in sequential mode, as they could be called while reading a stream.

存在しない列を読み取ろうとしています。 Trying to read a column that does not exist.

T がデータ ソースから返された型に一致しないか、キャストできません。 T doesn’t match the type returned by the data source or cannot be cast.

注釈

T 次の種類のいずれかを指定できます。T can be one of the following types:

ブール型Boolean ByteByte CharChar DateTimeDateTime
DateTimeOffsetDateTimeOffset Decimal (10 進数型)Decimal 倍精度浮動小数点型Double FloatFloat
GUIDGuid Int16Int16 Int32Int32 Int64Int64
StringString

詳細については、次を参照してください。 SqlClient ストリーミング サポートします。For more information, see SqlClient Streaming Support.

適用対象