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

ServiceBusSender.CreateMessageBatchAsync 方法

定义

命名空间:

Azure.Messaging.ServiceBus

程序集:

Azure.Messaging.ServiceBus.dll

包:

Azure.Messaging.ServiceBus v7.17.5

重载

CreateMessageBatchAsync(CancellationToken)	创建可以使用 添加到TryAddMessage(ServiceBusMessage)的大小ServiceBusMessage约束批。 如果消息超出批允许的最大大小，则批将不允许添加消息，并使用该消息返回值发出信号。 由于无法添加违反大小约束的消息，因此发布批处理不会在尝试将消息发送到队列/主题时触发异常。
CreateMessageBatchAsync(CreateMessageBatchOptions, CancellationToken)	创建可以使用基于 try 的模式添加到的大小 ServiceBusMessage 约束批。 如果消息超出批允许的最大大小，则批将不允许添加消息，并使用该消息的返回值发出信号。 由于无法添加违反大小约束的消息，因此发布批处理不会在尝试将消息发送到队列/主题时触发异常。

CreateMessageBatchAsync(CancellationToken)

Source:

ServiceBusSender.cs

创建可以使用 添加到TryAddMessage(ServiceBusMessage)的大小ServiceBusMessage约束批。 如果消息超出批允许的最大大小，则批将不允许添加消息，并使用该消息返回值发出信号。

由于无法添加违反大小约束的消息，因此发布批处理不会在尝试将消息发送到队列/主题时触发异常。

public virtual System.Threading.Tasks.ValueTask<Azure.Messaging.ServiceBus.ServiceBusMessageBatch> CreateMessageBatchAsync (System.Threading.CancellationToken cancellationToken = default);

abstract member CreateMessageBatchAsync : System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<Azure.Messaging.ServiceBus.ServiceBusMessageBatch>
override this.CreateMessageBatchAsync : System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<Azure.Messaging.ServiceBus.ServiceBusMessageBatch>

Public Overridable Function CreateMessageBatchAsync (Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of ServiceBusMessageBatch)

参数

cancellationToken

CancellationToken

一个可选 CancellationToken 实例，用于向请求发出取消操作的信号。

返回

ValueTask<ServiceBusMessageBatch>

ServiceBusMessageBatch具有默认批处理选项的 。

另请参阅

• CreateMessageBatchAsync(CreateMessageBatchOptions, CancellationToken)

CreateMessageBatchAsync(CreateMessageBatchOptions, CancellationToken)

Source:

ServiceBusSender.cs

创建可以使用基于 try 的模式添加到的大小 ServiceBusMessage 约束批。 如果消息超出批允许的最大大小，则批将不允许添加消息，并使用该消息的返回值发出信号。

由于无法添加违反大小约束的消息，因此发布批处理不会在尝试将消息发送到队列/主题时触发异常。

public virtual System.Threading.Tasks.ValueTask<Azure.Messaging.ServiceBus.ServiceBusMessageBatch> CreateMessageBatchAsync (Azure.Messaging.ServiceBus.CreateMessageBatchOptions options, System.Threading.CancellationToken cancellationToken = default);

abstract member CreateMessageBatchAsync : Azure.Messaging.ServiceBus.CreateMessageBatchOptions * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<Azure.Messaging.ServiceBus.ServiceBusMessageBatch>
override this.CreateMessageBatchAsync : Azure.Messaging.ServiceBus.CreateMessageBatchOptions * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<Azure.Messaging.ServiceBus.ServiceBusMessageBatch>

Public Overridable Function CreateMessageBatchAsync (options As CreateMessageBatchOptions, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of ServiceBusMessageBatch)

参数

options

CreateMessageBatchOptions

创建此批处理时要考虑的选项集。

cancellationToken

CancellationToken

一个可选 CancellationToken 实例，用于向请求发出取消操作的信号。

返回

ValueTask<ServiceBusMessageBatch>

具有 ServiceBusMessageBatch 所请求的 options。

另请参阅

• CreateMessageBatchAsync(CreateMessageBatchOptions, CancellationToken)