MemoryCache.CreateCacheEntryChangeMonitor 方法

定義

命名空間:
System.Runtime.Caching
組件:
System.Runtime.Caching.dll

建立 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 實例會立即被設定為變更狀態。 這表示當程式碼隨後綁定變更通知回撥時，回調會立即被觸發。

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

適用於