MemoryCache.CreateCacheEntryChangeMonitor 方法

定義

命名空間:

System.Runtime.Caching

組件:

System.Runtime.Caching.dll

套件:

System.Runtime.Caching v11.0.0-rc.1.26425.128

來源:

MemoryCache.cs

建立 CacheEntryChangeMonitor 一個物件，能因指定快取項目的變更而觸發事件。

public override System.Runtime.Caching.CacheEntryChangeMonitor CreateCacheEntryChangeMonitor(System.Collections.Generic.IEnumerable<string> keys, string regionName = default);

override this.CreateCacheEntryChangeMonitor : seq<string> * string -> System.Runtime.Caching.CacheEntryChangeMonitor

Public Overrides Function CreateCacheEntryChangeMonitor (keys As IEnumerable(Of String), Optional regionName As String = Nothing) As CacheEntryChangeMonitor

參數

keys

IEnumerable<String>

物件唯一快取入口金鑰 CacheEntryChangeMonitor 的枚舉。

regionName

String

快取中可新增快取條目的指定區域。 不要傳遞該參數的值。 這個參數是 null 預設的，因為該 MemoryCache 類別不實作區域。

傳回

CacheEntryChangeMonitor

一個監控快取項目的變更監控器。

例外狀況

NotSupportedException

regionName 不是 null。

ArgumentNullException

keys 是 null。

ArgumentException

集合中的 keys 一個項目為 null。

備註

此方法會 CreateCacheEntryChangeMonitor 建立一個 CacheEntryChangeMonitor 實例。 這個專門的變更監控器用來監控集合中指定的 keys 快取項目，並在項目變更時觸發事件。

受監控的條目因以下任一原因被視為變更：

• 在呼叫 CreateCacheEntryChangeMonitor 方法時，該金鑰並不存在。 在這種情況下，產生的 CacheEntryChangeMonitor 實例會立即被設定為變更狀態。 這表示當程式碼隨後綁定變更通知回撥時，回調會立即被觸發。

• 與快取相關的條目被移除。 這可能發生在條目被明確移除、它過期，或是為了恢復記憶體而被驅逐時