DbBatch.ExecuteNonQueryAsync(CancellationToken) 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
这是 ExecuteNonQuery() 的异步版本。 提供程序应使用合适的实现进行重写。 可选择性忽略取消标记。
默认实现调用同步 ExecuteNonQuery() 方法并返回已完成任务,以便阻止调用线程。 如果传递到已取消的取消标记,则默认实现将返回已取消的任务。 ExecuteNonQuery() 引发的异常将通过任务异常属性传递。
在返回的任务完成前,不要调用 DbCommand
对象的其他方法和属性。
public abstract System.Threading.Tasks.Task<int> ExecuteNonQueryAsync (System.Threading.CancellationToken cancellationToken = default);
abstract member ExecuteNonQueryAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<int>
Public MustOverride Function ExecuteNonQueryAsync (Optional cancellationToken As CancellationToken = Nothing) As Task(Of Integer)
参数
- cancellationToken
- CancellationToken
用于取消异步操作的令牌。
返回
表示异步操作的任务。
例外
执行批处理时出错。
取消令牌已取消。 此异常存储在返回的任务中。
注解
有关异步编程的详细信息,请参阅 异步编程。
此方法将存储在任务中,它返回该方法的同步对应项可能引发的所有非使用异常。 如果异常存储在返回的任务中,则在等待任务时将引发该异常。 使用异常(如 ArgumentException)仍会同步引发。 有关存储的异常,请参阅 引发的 ExecuteNonQuery()异常。