DbCommand.ExecuteNonQueryAsync メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
このメソッドは、ExecuteNonQuery() の非同期バージョンを実装しますが、Task を同期的に返し、スレッドの呼び出しをブロックします。
オーバーロード
| ExecuteNonQueryAsync(CancellationToken) |
これは ExecuteNonQuery() の非同期バージョンです。 プロバイダーは、適切な実装でオーバーライドする必要があります。 オプションで、キャンセル トークンを無視できます。 既定の実装は ExecuteNonQuery() 同期メソッドを呼び出し、完了したタスクを返します。呼び出し元のスレッドはブロックされます。 既定の実装は、既に取り消されたキャンセル トークンを渡した場合、取り消されたタスクを返します。 ExecuteNonQuery() によってスローされる例外は、返されたタスクの Exception プロパティを介して通信されます。 返されたタスクが完了するまで |
| ExecuteNonQueryAsync() |
影響を受ける行数 ExecuteNonQuery()を返す、接続オブジェクトに対してコマンドを実行する非同期バージョン。 CancellationToken.None を使用して、ExecuteNonQueryAsync(CancellationToken) を呼び出します。 |
注釈
非同期プログラミングの詳細については、「 非同期プログラミング」を参照してください。
ExecuteNonQueryAsync(CancellationToken)
これは ExecuteNonQuery() の非同期バージョンです。 プロバイダーは、適切な実装でオーバーライドする必要があります。 オプションで、キャンセル トークンを無視できます。
既定の実装は ExecuteNonQuery() 同期メソッドを呼び出し、完了したタスクを返します。呼び出し元のスレッドはブロックされます。 既定の実装は、既に取り消されたキャンセル トークンを渡した場合、取り消されたタスクを返します。 ExecuteNonQuery() によってスローされる例外は、返されたタスクの Exception プロパティを介して通信されます。
返されたタスクが完了するまで 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
非同期操作を取り消すトークン。
戻り値
非同期操作を表すタスク。
例外
コマンドの実行中にエラーが発生しました。
注釈
非同期プログラミングの詳細については、「 非同期プログラミング」を参照してください。
こちらもご覧ください
適用対象
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)
戻り値
非同期操作を表すタスク。
例外
コマンドの実行中にエラーが発生しました。
注釈
非同期プログラミングの詳細については、「 非同期プログラミング」を参照してください。