MemoryCache.CreateCacheEntryChangeMonitor 方法

定義

命名空間:

System.Runtime.Caching

組件:

System.Runtime.Caching.dll

套件:

System.Runtime.Caching v9.0.0-rc.2.24473.5

來源:

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 實例會立即設定為已變更的狀態。 這表示，當程式代碼後續系結變更通知回呼時，會立即觸發回呼。

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