SqlCommand.ExecuteNonQueryAsync(CancellationToken) メソッド

定義

名前空間:

Microsoft.Data.SqlClient

アセンブリ:

Microsoft.Data.SqlClient.dll

パッケージ:

Microsoft.Data.SqlClient v5.2.0

の非同期バージョン ExecuteNonQuery() 。これは、接続に対して Transact-SQL ステートメントを実行し、影響を受ける行数を返します。 キャンセル トークンを使用すると、コマンド タイムアウトが経過する前に操作を破棄するように要求できます。 例外は、返されたタスク オブジェクトによって報告されます。

public:
 override System::Threading::Tasks::Task<int> ^ ExecuteNonQueryAsync(System::Threading::CancellationToken cancellationToken);

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

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

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

パラメーター

cancellationToken

CancellationToken

取り消し命令。

戻り値

Task<Int32>

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

例外

InvalidCastException

SqlDbTypeが にStream設定されている場合Valueは、Binary または VarBinary 以外の が使用されました。 ストリーミングの詳細については、「SqlClient ストリーミング サポート」を参照してください。

- または -

SqlDbTypeが にTextReader設定されている場合Value、Char、NChar、NVarChar、VarChar、または Xml 以外の が使用されました。

または

SqlDbTypeが にXmlReader設定されたときに Xml 以外の がValue使用されました。

InvalidOperationException

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

- または -

ストリーミング操作中に、SqlConnection が閉じられたか切断されました。 ストリーミングの詳細については、「SqlClient ストリーミング サポート」を参照してください。

SqlException

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

- または -

ストリーミング操作中にタイムアウトが発生しました。 ストリーミングの詳細については、「SqlClient ストリーミング サポート」を参照してください。

IOException

ストリーミング操作中に、 Stream オブジェクト XmlReader または TextReader オブジェクトでエラーが発生しました。 ストリーミングの詳細については、「SqlClient ストリーミング サポート」を参照してください。

ObjectDisposedException

XmlReader、または TextReader オブジェクトはStream、ストリーミング操作中に閉じられました。 ストリーミングの詳細については、「SqlClient ストリーミング サポート」を参照してください。

注釈

SQL Serverの.NET Framework データ プロバイダーでの非同期プログラミングの詳細については、「非同期プログラミング」を参照してください。

注意

サーバーで実行時間の長いクエリの場合は、キャンセル トークンを使用したクエリの取り消しに関する既知の問題が原因で を使用 ExecuteNonQuery することを検討してください。 また、 メソッドを使用して Cancel 実行を取り消すこともできます。