DbCommand.ExecuteNonQueryAsync メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
このメソッドは、 ExecuteNonQuery()の非同期バージョンを実装しますが、同期的に Task を返し、呼び出し元のスレッドをブロックします。
オーバーロード
| 名前 | 説明 |
|---|---|
| ExecuteNonQueryAsync(CancellationToken) |
これは、 ExecuteNonQuery()の非同期バージョンです。 プロバイダーは、適切な実装でオーバーライドする必要があります。 キャンセル トークンは、必要に応じて無視できます。 既定の実装では、同期 ExecuteNonQuery() メソッドが呼び出され、完了したタスクが返され、呼び出し元のスレッドがブロックされます。 既定の実装では、既に取り消されたキャンセル トークンが渡された場合、取り消されたタスクが返されます。 ExecuteNonQuery()によってスローされた例外は、返された Task Exception プロパティを介して伝達されます。 返された Task が完了するまで、 |
| ExecuteNonQueryAsync() |
ExecuteNonQuery()の非同期バージョン。接続オブジェクトに対してコマンドを実行し、影響を受けた行数を返します。 CancellationToken.None を使用して ExecuteNonQueryAsync(CancellationToken) を呼び出します。 |
注釈
非同期プログラミングの詳細については、「 非同期プログラミング」を参照してください。
ExecuteNonQueryAsync(CancellationToken)
これは、 ExecuteNonQuery()の非同期バージョンです。 プロバイダーは、適切な実装でオーバーライドする必要があります。 キャンセル トークンは、必要に応じて無視できます。
既定の実装では、同期 ExecuteNonQuery() メソッドが呼び出され、完了したタスクが返され、呼び出し元のスレッドがブロックされます。 既定の実装では、既に取り消されたキャンセル トークンが渡された場合、取り消されたタスクが返されます。 ExecuteNonQuery()によってスローされた例外は、返された Task Exception プロパティを介して伝達されます。
返された Task が完了するまで、 DbCommand オブジェクトの他のメソッドとプロパティを呼び出さないでください。
public:
virtual System::Threading::Tasks::Task<int> ^ ExecuteNonQueryAsync(System::Threading::CancellationToken cancellationToken);public virtual System.Threading.Tasks.Task<int> ExecuteNonQueryAsync(System.Threading.CancellationToken cancellationToken);abstract member ExecuteNonQueryAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<int>
override this.ExecuteNonQueryAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<int>Public Overridable Function ExecuteNonQueryAsync (cancellationToken As CancellationToken) As Task(Of Integer)パラメーター
- cancellationToken
- CancellationToken
非同期操作を取り消すトークン。
返品
非同期操作を表すタスク。
例外
コマンドの実行中にエラーが発生しました。
キャンセル トークンが取り消されました。 この例外は、返されたタスクに格納されます。
注釈
非同期プログラミングの詳細については、「 非同期プログラミング」を参照してください。
このメソッドは、メソッドの同期的な例外がスローできるすべての非使用例外を返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクが待機しているときにスローされます。 ArgumentException などの使用に関する例外は、引き続き同期的にスローされます。 格納されている例外については、 ExecuteNonQuery()によってスローされる例外を参照してください。
こちらもご覧ください
適用対象
ExecuteNonQueryAsync()
ExecuteNonQuery()の非同期バージョン。接続オブジェクトに対してコマンドを実行し、影響を受けた行数を返します。
CancellationToken.None を使用して ExecuteNonQueryAsync(CancellationToken) を呼び出します。
public:
System::Threading::Tasks::Task<int> ^ ExecuteNonQueryAsync();public System.Threading.Tasks.Task<int> ExecuteNonQueryAsync();member this.ExecuteNonQueryAsync : unit -> System.Threading.Tasks.Task<int>Public Function ExecuteNonQueryAsync () As Task(Of Integer)返品
非同期操作を表すタスク。
例外
コマンドの実行中にエラーが発生しました。
注釈
非同期プログラミングの詳細については、「 非同期プログラミング」を参照してください。
このメソッドは、メソッドの同期的な例外がスローできるすべての非使用例外を返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクが待機しているときにスローされます。 ArgumentException などの使用に関する例外は、引き続き同期的にスローされます。 格納されている例外については、 ExecuteNonQuery()によってスローされる例外を参照してください。