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

EventHubProducerClient.CreateBatchAsync 方法

定义

命名空间:

Azure.Messaging.EventHubs.Producer

程序集:

Azure.Messaging.EventHubs.dll

包:

Azure.Messaging.EventHubs v5.11.3

重载

CreateBatchAsync(CancellationToken)	创建可以使用基于 try 的模式添加到的大小 EventData 约束批。 如果事件超出批的最大允许大小，则批处理将不允许添加事件，并使用该事件返回值发出信号。 由于无法添加违反大小约束的事件，因此发布批处理不会在尝试将事件发送到事件中心服务时触发异常。
CreateBatchAsync(CreateBatchOptions, CancellationToken)	创建可以使用基于 try 的模式添加到的大小 EventData 约束批。 如果事件超出批的最大允许大小，则批处理将不允许添加事件，并使用该事件返回值发出信号。 由于无法添加违反大小约束的事件，因此发布批处理不会在尝试将事件发送到事件中心服务时触发异常。

CreateBatchAsync(CancellationToken)

Source:

EventHubProducerClient.cs

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

由于无法添加违反大小约束的事件，因此发布批处理不会在尝试将事件发送到事件中心服务时触发异常。

public virtual System.Threading.Tasks.ValueTask<Azure.Messaging.EventHubs.Producer.EventDataBatch> CreateBatchAsync (System.Threading.CancellationToken cancellationToken = default);

abstract member CreateBatchAsync : System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<Azure.Messaging.EventHubs.Producer.EventDataBatch>
override this.CreateBatchAsync : System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<Azure.Messaging.EventHubs.Producer.EventDataBatch>

Public Overridable Function CreateBatchAsync (Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of EventDataBatch)

参数

cancellationToken

CancellationToken

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

返回

ValueTask<EventDataBatch>

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

另请参阅

• CreateBatchAsync(CreateBatchOptions, CancellationToken)
• SendAsync(EventDataBatch, CancellationToken)

CreateBatchAsync(CreateBatchOptions, CancellationToken)

Source:

EventHubProducerClient.cs

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

由于无法添加违反大小约束的事件，因此发布批处理不会在尝试将事件发送到事件中心服务时触发异常。

public virtual System.Threading.Tasks.ValueTask<Azure.Messaging.EventHubs.Producer.EventDataBatch> CreateBatchAsync (Azure.Messaging.EventHubs.Producer.CreateBatchOptions options, System.Threading.CancellationToken cancellationToken = default);

abstract member CreateBatchAsync : Azure.Messaging.EventHubs.Producer.CreateBatchOptions * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<Azure.Messaging.EventHubs.Producer.EventDataBatch>
override this.CreateBatchAsync : Azure.Messaging.EventHubs.Producer.CreateBatchOptions * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<Azure.Messaging.EventHubs.Producer.EventDataBatch>

Public Overridable Function CreateBatchAsync (options As CreateBatchOptions, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of EventDataBatch)

参数

options

CreateBatchOptions

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

cancellationToken

CancellationToken

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

返回

ValueTask<EventDataBatch>

具有 EventDataBatch 所请求的 options。

例外

InvalidOperationException

在 中同时指定了分区标识符和分区键时发生 options。

另请参阅

• SendAsync(EventDataBatch, CancellationToken)
• CreateBatchAsync(CancellationToken)