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

EventProcessorClientOptions.PrefetchCount 属性

定义

命名空间:

Azure.Messaging.EventHubs

程序集:

Azure.Messaging.EventHubs.Processor.dll

包:

Azure.Messaging.EventHubs.Processor v5.11.3

Source:

EventProcessorClientOptions.cs

将从事件中心服务急切请求并在本地排队而不考虑读取操作当前是否处于活动状态的事件数，旨在通过允许从本地缓存读取事件而不是等待服务请求来帮助最大化吞吐量。

public int PrefetchCount { get; set; }

member this.PrefetchCount : int with get, set

Public Property PrefetchCount As Integer

属性值

Int32

PrefetchCount是一个控件，开发人员可以使用它来帮助优化性能，以满足应用程序的特定需求，给定其预期的事件大小、吞吐量需求和使用事件中心的预期方案。

默认预提取计数为 300。

例外

ArgumentOutOfRangeException

当请求的计数为负时发生。

注解

预提取计数的大小会影响从事件中心服务读取事件的效率。 缓存的大小越大，在后台缓冲服务操作的效率就越高，以提高吞吐量。 这要以额外的内存使用为代价，并可能增加网络 I/O。

对于事件大小较小且许多事件流经系统的情况，使用较大CacheEventCountPrefetchCount事件有助于提高吞吐量。 对于事件大小较大或事件处理预期操作较重且速度较慢的情况，使用较小大小 CacheEventCount 有助于 PrefetchCount 管理资源使用，而不会造成吞吐量的不小成本。

无论值如何，通常建议 PrefetchCount 至少是 的 2-3 倍大 CacheEventCount ，以便有效地缓冲服务操作。