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

Azure.Messaging.EventHubs.Producer 命名空间

CreateBatchOptions

可以指定用于影响事件批处理的行为方式的选项集,并将其发送到事件中心服务。

EnqueueEventOptions

可指定用于影响事件发布到事件中心服务的方式的选项集。

EventDataBatch

一组 EventData 具有大小约束的预先已知,旨在通过单个操作发送到事件中心服务。 发布后,结果为原子;属于批处理的所有事件都成功或全部失败。 部分成功是不可能的。

EventHubBufferedProducerClient

负责将 实例 EventData 发布到特定事件中心的客户端。 根据事件排队时指定的选项,它们可能会自动分配给分区、根据指定的分区键进行分组或分配专门请求的分区。

EventHubBufferedProducerClient不会立即发布,而是使用延迟模型,其中将事件收集到缓冲区中,以便在批处理已满或MaximumWaitTime已过且未排队新事件时有效地批处理和发布它们。

此模型旨在将批处理管理的负担从调用方转移,代价是非确定性计时,以用于发布事件的时间。 此外,还需要考虑其他权衡:

  • 如果应用程序崩溃,则缓冲区中的事件将不会发布。 为了防止数据丢失,建议调用方使用 SendEventBatchSucceededAsyncSendEventBatchFailedAsync 处理程序跟踪发布进度。
  • 为指定分区键的事件分配的分区可能不同于与其他生成者使用同一键的事件。
  • 如果分区暂时不可用, EventHubBufferedProducerClient 则 恢复所需的时间可能比其他生成者长。

如果必须立即发布具有确定性结果的事件,请确保将分区键分配给与其他发布者一致的分区,或者需要最大化可用性,建议使用 EventHubProducerClient

EventHubBufferedProducerClientOptions

创建 EventHubBufferedProducerClient 时可以指定的选项集,用于配置其行为。

EventHubProducerClient

负责发布到 EventData 特定事件中心的客户端,分批分组在一起。 根据发送时指定的选项,可以自动为事件分配可用分区,也可以请求特定分区。

EventHubProducerClient 立即发布,确保每个发送操作的确定性结果,但要求调用方负责生成和管理批处理。

如果立即发布事件并不重要,并且不需要最大化分区可用性,建议考虑使用 EventHubBufferedProducerClient负责生成和管理批处理,以降低在应用程序代码中执行此操作的复杂性。

EventHubProducerClientOptions

创建 EventHubProducerClient 时可以指定的选项集,用于配置其行为。

SendEventBatchFailedEventArgs

包含有关无法发布的批处理的信息,以及发生的异常以及将批处理发布到的分区。

SendEventBatchSucceededEventArgs

包含有关已发布的批处理及其发布到的分区的信息。

SendEventOptions

可指定用于影响事件发布到事件中心服务的方式的选项集。