Language

SqlDataReader.NextResultAsync(CancellationToken) メソッド

定義

バッチ Transact-SQL ステートメントの結果を読み取るときにデータ リーダーを次の結果に進める、 NextResult()の非同期バージョン。

      The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. Exceptions will be reported via the returned Task object.

      <p>For new development, use <a href="/sql/connect/ado-net/introduction-microsoft-data-sqlclient-namespace">Microsoft.Data.SqlClient</a>. This page documents System.Data.SqlClient.</p>
public:
 override System::Threading::Tasks::Task<bool> ^ NextResultAsync(System::Threading::CancellationToken cancellationToken);
public override System.Threading.Tasks.Task<bool> NextResultAsync(System.Threading.CancellationToken cancellationToken);
override this.NextResultAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>
Public Overrides Function NextResultAsync (cancellationToken As CancellationToken) As Task(Of Boolean)

パラメーター

cancellationToken
CancellationToken

取り消し命令。

戻り値

非同期操作を表すタスク。

例外

タスクが完了する前に、同じインスタンスに対して NextResultAsync(CancellationToken) を複数回呼び出します。

Context Connection=trueは、接続文字列で指定します。

SQL Serverコマンド テキストの実行中にエラーが返されました。

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

注釈

SQL Serverの.NET Framework Data Providerでの非同期プログラミングの詳細については、「Asynchronous Programming」を参照してください。

このメソッドは、メソッドの同期的な例外がスローできるすべての非使用例外を返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクが待機しているときにスローされます。 ArgumentException などの使用に関する例外は、引き続き同期的にスローされます。 格納されている例外については、 NextResult()によってスローされる例外を参照してください。

適用対象

関連項目