MemoryCache.CreateCacheEntryChangeMonitor メソッド

定義

名前空間:

System.Runtime.Caching

アセンブリ:

System.Runtime.Caching.dll

パッケージ:

System.Runtime.Caching v8.0.0

ソース:

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

キャッシュ エントリを追加できるキャッシュ内の名前付き領域。 このパラメーターには値を渡さないでください。 MemoryCache クラスは領域を実装しないため、このパラメーターは既定で null です。

戻り値

CacheEntryChangeMonitor

キャッシュ内のエントリを監視する変更監視機能。

例外

NotSupportedException

regionName が null ではありません。

ArgumentNullException

keys が nullです。

ArgumentException

keys コレクション内の項目が null です。

注釈

メソッドは CreateCacheEntryChangeMonitor インスタンスを CacheEntryChangeMonitor 作成します。 この特殊化された変更モニターは、コレクションで keys 指定されたキャッシュ エントリを監視し、エントリが変更されたときにイベントをトリガーするために使用されます。

監視対象のエントリは、次のいずれかの理由で変更されたと見なされます。

• メソッドの呼び出し時にキーが CreateCacheEntryChangeMonitor 存在しません。 その場合、結果 CacheEntryChangeMonitor のインスタンスはすぐに変更された状態に設定されます。 つまり、コードが変更通知コールバックを後でバインドすると、コールバックが直ちにトリガーされます。

• 関連付けられたキャッシュ エントリがキャッシュから削除されました。 これは、エントリが明示的に削除された場合、有効期限が切れた場合、またはメモリを回復するために削除された場合に発生する可能性があります