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)，该方法的所有预期异常也在此处适用。