你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

TransactionalBatch.ExecuteAsync 方法

参考

定义

命名空间:: Microsoft.Azure.Cosmos

程序集:: Microsoft.Azure.Cosmos.Client.dll

包:: Microsoft.Azure.Cosmos v3.39.0

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

重载

ExecuteAsync(CancellationToken)	将 Azure Cosmos 服务中的事务批处理作为异步操作执行。
ExecuteAsync(TransactionalBatchRequestOptions, CancellationToken)	将 Azure Cosmos 服务中的事务批处理作为异步操作执行。

ExecuteAsync(CancellationToken)

Source:: TransactionalBatch.cs

将 Azure Cosmos 服务中的事务批处理作为异步操作执行。

public abstract System.Threading.Tasks.Task<Microsoft.Azure.Cosmos.TransactionalBatchResponse> ExecuteAsync (System.Threading.CancellationToken cancellationToken = default);

abstract member ExecuteAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Cosmos.TransactionalBatchResponse>

Public MustOverride Function ExecuteAsync (Optional cancellationToken As CancellationToken = Nothing) As Task(Of TransactionalBatchResponse)

参数

cancellationToken: CancellationToken

(表示请求取消的可选) 取消令牌。

Task<TransactionalBatchResponse>

包含事务批处理执行详细信息的可等待响应。

如果事务批处理成功执行， StatusCode 则返回的响应上的将设置为 OK。

如果事务批处理中的操作在执行过程中失败，则不会提交批处理的更改，失败操作的状态将在中 StatusCode提供。若要获取有关失败操作的更多详细信息，可以枚举响应 - 这将返回 TransactionalBatchOperationResult 与事务批处理中每个操作相对应的实例，这些实例将按添加到事务批处理中的顺序返回。对于与事务批处理中的操作对应的结果， StatusCode 指示操作的状态 - 如果操作未执行或由于事务批处理中另一个操作失败而中止，则此字段的值将为 HTTP 424 (失败的依赖项) ;对于导致批处理中止的操作，此字段的值将以 HTTP 状态代码的形式指示失败原因。

StatusCode返回的响应中可能还具有 HTTP 5xx 等值（如果出现服务器错误）和 HTTP 429 () 请求过多。

注解

此 API 仅在客户端异常上引发。这是为了提高性能并防止引发异常的开销。对返回的响应使用 IsSuccessStatusCode 以确保事务批处理成功。事务性Batch 请求的限制

适用于

ExecuteAsync(TransactionalBatchRequestOptions, CancellationToken)

Source:: TransactionalBatch.cs