SqlBatch.ExecuteNonQueryAsync(CancellationToken) メソッド

定義

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

これは ExecuteNonQuery() の非同期バージョンです。

実装はメソッドを ExecuteNonQueryAsync(CancellationToken) 呼び出し、完了したタスクを返します。既定の実装は、既に取り消されたキャンセルトークンを渡した場合、取り消されたタスクを返します。

返されたタスクが完了するまで DbCommand オブジェクトの他のメソッドとプロパティを呼び出さないでください。

public override System.Threading.Tasks.Task<int> ExecuteNonQueryAsync (System.Threading.CancellationToken cancellationToken = default);

override this.ExecuteNonQueryAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<int>

Public Overrides Function ExecuteNonQueryAsync (Optional cancellationToken As CancellationToken = Nothing) As Task(Of Integer)

非同期操作を取り消すトークン。

Task<Int32>

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

SqlException

バッチの実行中にエラーが発生しました。

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

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

返されたタスクに例外が格納されている場合、その例外はタスクが待機されたときにスローされます。などの ArgumentException使用例外は、引き続き同期的にスローされます。

注意

このメソッドはから ExecuteNonQueryAsync(CancellationToken)メリットを得て、そのメソッドの予期されるすべての例外もここに適用されます。