MemoryCache.CreateCacheEntryChangeMonitor 方法

定義

建立 CacheEntryChangeMonitor 物件,該物件可觸發事件以回應指定快取項目的變更。

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

參數

keys
IEnumerable<String>

CacheEntryChangeMonitor 物件之唯一快取項目索引鍵的列舉。

regionName
String

快取區中的具名區域,快取項目可以加入至這個區域。 請勿傳遞這個參數的值。 這個參數預設為 null,因為 MemoryCache 類別沒有實作區域。

傳回

監控快取區項目的變更監視器。

例外狀況

regionName 不是 null

keysnull

keys 集合中的某個項目為 null

備註

方法 CreateCacheEntryChangeMonitorCacheEntryChangeMonitor 建立 實例。 這個特製化變更監視器可用來監視集合中指定的 keys 快取專案,以及在專案變更時觸發事件。

由於下列任何原因,受監視的專案會被視為已變更:

  • 在呼叫 CreateCacheEntryChangeMonitor 方法時,索引鍵不存在。 在此情況下,產生的 CacheEntryChangeMonitor 實例會立即設定為已變更的狀態。 這表示,當程式代碼後續系結變更通知回呼時,會立即觸發回呼。

  • 相關聯的快取專案已從快取中移除。 如果專案已明確移除、到期,或已收回以復原記憶體,就會發生這種情況

適用於

產品 版本
.NET 8 (package-provided), 9 (package-provided)
.NET Framework 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7 (package-provided), 4.7, 4.7.1 (package-provided), 4.7.1, 4.7.2 (package-provided), 4.7.2, 4.8 (package-provided), 4.8, 4.8.1
.NET Standard 2.0 (package-provided)