DbCommand.ExecuteNonQueryAsync メソッド

定義

このメソッドは、ExecuteNonQuery() の非同期バージョンを実装しますが、Task を同期的に返し、スレッドの呼び出しをブロックします。

オーバーロード

ExecuteNonQueryAsync(CancellationToken)

これは ExecuteNonQuery() の非同期バージョンです。 プロバイダーは、適切な実装でオーバーライドする必要があります。 オプションで、キャンセル トークンを無視できます。

既定の実装は ExecuteNonQuery() 同期メソッドを呼び出し、完了したタスクを返します。呼び出し元のスレッドはブロックされます。 既定の実装は、既に取り消されたキャンセル トークンを渡した場合、取り消されたタスクを返します。 ExecuteNonQuery() によってスローされる例外は、返されたタスクの Exception プロパティを介して通信されます。

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

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

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

戻り値

Task<Int32>

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

例外

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

注釈

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

こちらもご覧ください

適用対象

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)

戻り値

Task<Int32>

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

例外

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

注釈

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

こちらもご覧ください

適用対象