SqlDataReader.IsDBNullAsync(Int32, CancellationToken) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
IsDBNull(Int32)の非同期バージョン。列に存在しない値または欠損値が含まれているかどうかを示す値を取得します。
キャンセル トークンを使用して、コマンドのタイムアウトが経過する前に操作を破棄するように要求できます。 例外は、返された Task オブジェクトを介して報告されます。
public:
override System::Threading::Tasks::Task<bool> ^ IsDBNullAsync(int i, System::Threading::CancellationToken cancellationToken);public override System.Threading.Tasks.Task<bool> IsDBNullAsync(int i, System.Threading.CancellationToken cancellationToken);override this.IsDBNullAsync : int * System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>Public Overrides Function IsDBNullAsync (i As Integer, cancellationToken As CancellationToken) As Task(Of Boolean)パラメーター
- i
- Int32
取得する 0 から始まる列。
- cancellationToken
- CancellationToken
取り消し命令。操作を取り消す必要があることを示す通知を伝達します。 キャンセルは保証されません。
CancellationToken.Noneを設定すると、このメソッドはIsDBNull(Int32)と同等になります。 返されるタスクは、取り消し済みとしてマークする必要があります。
返品
true 指定した列値が DBNull と等しい場合は false。
例外
データの取得中に接続が切断されるか、閉じられます。
SqlDataReaderは、データの取得中に閉じられます。
読み取る準備ができているデータがありません (たとえば、最初の Read() が呼び出されていないか、false が返されました)。
シーケンシャル モードで以前に読み取った列を読み取ろうとしています。
非同期操作が進行中でした。 これは、ストリームの読み取り中に呼び出すことができるため、シーケンシャル モードで実行されている場合は、すべての Get* メソッドに適用されます。
Context Connection=trueは、接続文字列で指定します。
存在しない列を読み取ろうとしています。
キャンセル トークンが取り消されました。 この例外は、返されたタスクに格納されます。
注釈
詳細については、「 SqlClient ストリーミング サポート」を参照してください。
このメソッドは、メソッドの同期的な例外がスローできるすべての非使用例外を返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクが待機しているときにスローされます。 ArgumentException などの使用に関する例外は、引き続き同期的にスローされます。 格納されている例外については、 IsDBNull(Int32)によってスローされる例外を参照してください。