DbDataReader.NextResultAsync メソッド

定義

名前空間:

System.Data.Common

アセンブリ:

System.Data.Common.dll

バッチ ステートメントの結果を読み取っているときに、次の結果にリーダーを非同期で進めます。

オーバーロード

NextResultAsync()	バッチ ステートメントの結果を読み取っているときに、次の結果にリーダーを非同期で進めます。
NextResultAsync(CancellationToken)	バッチ ステートメントの結果を読み取っているときに、次の結果にリーダーを非同期で進めます。

注釈

非同期プログラミングの詳細については、「非同期 プログラミング」を参照してください。

NextResultAsync()

ソース:

DbDataReader.cs

バッチ ステートメントの結果を読み取っているときに、次の結果にリーダーを非同期で進めます。

public:
 System::Threading::Tasks::Task<bool> ^ NextResultAsync();

public System.Threading.Tasks.Task<bool> NextResultAsync ();

member this.NextResultAsync : unit -> System.Threading.Tasks.Task<bool>

Public Function NextResultAsync () As Task(Of Boolean)

戻り値

Task<Boolean>

Result プロパティが、結果セットが他にもある場合は true、ない場合は false となるタスク。

例外

DbException

コマンド テキストの実行中にエラーが発生しました。

注釈

この非同期メソッドの既定の実装では、対応する同期メソッドが呼び出され、完了した Task が返され、呼び出し元のスレッドがブロックされる可能性があります。

非同期プログラミングをサポートするデータ プロバイダーは、非同期 I/O 操作を使用して既定の実装をオーバーライドする必要があります。

返されたタスクが完了していないうちは、DbDataReader のオブジェクトの他のメソッドとプロパティを呼び出さないでください。 このメソッドは、メソッドの同期的な例外がスローできる非使用例外をすべて返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクの待機時にスローされます。 などの ArgumentException使用例外は、引き続き同期的にスローされます。 格納されている例外については、 によって NextResult()スローされる例外に関するページを参照してください。

こちらもご覧ください

• ADO.NET の概要

NextResultAsync(CancellationToken)

ソース:

DbDataReader.cs

バッチ ステートメントの結果を読み取っているときに、次の結果にリーダーを非同期で進めます。

public:
 virtual System::Threading::Tasks::Task<bool> ^ NextResultAsync(System::Threading::CancellationToken cancellationToken);

public virtual System.Threading.Tasks.Task<bool> NextResultAsync (System.Threading.CancellationToken cancellationToken);

abstract member NextResultAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>
override this.NextResultAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>

Public Overridable Function NextResultAsync (cancellationToken As CancellationToken) As Task(Of Boolean)

パラメーター

cancellationToken

CancellationToken

取り消し命令。

戻り値

Task<Boolean>

結果セットが他にもある場合は Result プロパティが true で、ない場合は false の Task<TResult>。

例外

DbException

コマンド テキストの実行中にエラーが発生しました。

OperationCanceledException

キャンセル トークンが取り消されました。 この例外は、返されたタスクに格納されます。

注釈

この非同期メソッドの既定の実装では、対応する同期メソッドが呼び出され、完了した Task が返され、呼び出し元のスレッドがブロックされる可能性があります。 既定の実装では、既に取り消されたキャンセル トークンが渡された場合、取り消されたタスクも返されます。

非同期プログラミングをサポートするデータ プロバイダーは、非同期 I/O 操作を使用して既定の実装をオーバーライドする必要があります。

このメソッドは、早期に操作をキャンセルすることを要求するために使用できるキャンセル トークンを受け取ります。 実装は、この要求を無視する場合があります。

返されたタスクが完了していないうちは、DbDataReader のオブジェクトの他のメソッドとプロパティを呼び出さないでください。 このメソッドは、メソッドの同期的な例外がスローできる非使用例外をすべて返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクの待機時にスローされます。 などの ArgumentException使用例外は、引き続き同期的にスローされます。 格納されている例外については、 によって NextResult()スローされる例外に関するページを参照してください。

こちらもご覧ください

• ADO.NET の概要