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

ReadEventOptions.CacheEventCount 属性

定义

命名空间:

Azure.Messaging.EventHubs.Consumer

程序集:

Azure.Messaging.EventHubs.dll

包:

Azure.Messaging.EventHubs v5.11.3

Source:

ReadEventOptions.cs

从事件中心服务读取并在读取处于活动状态且事件被发送到枚举器进行处理时保存在本地内存缓存中的最大事件数。

public int CacheEventCount { get; set; }

member this.CacheEventCount : int with get, set

Public Property CacheEventCount As Integer

属性值

Int32

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

例外

ArgumentOutOfRangeException

当请求的计数小于 1 时发生。

注解

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

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

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