DataCacheNotificationCallback デリゲート
1 つ以上のキャッシュ操作が行われた場合にキャッシュ通知により呼び出されるコールバック メソッドを表します。
名前空間: Microsoft.ApplicationServer.Caching
アセンブリ: Microsoft.ApplicationServer.Caching.Client (microsoft.applicationserver.caching.client.dll)
使用法
構文
'宣言
Public Delegate Sub DataCacheNotificationCallback ( _
cacheName As String, _
regionName As String, _
key As String, _
version As DataCacheItemVersion, _
cacheOperation As DataCacheOperations, _
nd As DataCacheNotificationDescriptor _
)
public delegate void DataCacheNotificationCallback (
string cacheName,
string regionName,
string key,
DataCacheItemVersion version,
DataCacheOperations cacheOperation,
DataCacheNotificationDescriptor nd
)
public delegate void DataCacheNotificationCallback (
String^ cacheName,
String^ regionName,
String^ key,
DataCacheItemVersion^ version,
DataCacheOperations cacheOperation,
DataCacheNotificationDescriptor^ nd
)
/** @delegate */
public delegate void DataCacheNotificationCallback (
String cacheName,
String regionName,
String key,
DataCacheItemVersion version,
DataCacheOperations cacheOperation,
DataCacheNotificationDescriptor nd
)
パラメーター
- CacheName
キャッシュ操作と関連付けられたキャッシュの名前です。
- regionName
キャッシュ操作と関連付けられたリージョンの名前です。 長さゼロの文字列は、特定のリージョンがキャッシュ操作と関連付けられていないことを示しています。
- key
キャッシュ操作と関連付けられたキーの名前です。 長さゼロの文字列は、特定のキャッシュされた項目がキャッシュ操作と関連付けられていないことを示しています。
- version
通知をトリガーしたキャッシュ操作と関連付けられているキャッシュされたオブジェクトの DataCacheItemVersion です。 null バージョンは、特定のキャッシュされた項目がキャッシュ操作と関連付けられていないことを示しています。
- cacheOperation
どのキャッシュ イベントがキャッシュ通知をトリガーしたかを指定する DataCacheOperations 列挙です。
- nd
デリゲート メソッドを呼び出したキャッシュ通知と関連付けられた DataCacheNotificationDescriptor オブジェクトです。
解説
キャッシュ通知コールバックを追加するには 2 つの手順が必要です。 まず、1 つ以上のキャッシュ操作によってキャッシュ通知が発生したときに呼び出されるメソッドを作成します。 キャッシュ通知を使用して呼び出すメソッドは、DataCacheNotificationCallback デリゲートと同じパラメーターを受け入れる必要があります。 次に、DataCache オブジェクトから利用可能な 3 つのメソッドのいずれかを使用して、コールバックを追加します。 AddCacheLevelCallback、AddRegionLevelCallback、または Override:Microsoft.ApplicationServer.Caching.DataCache.AddItemLevelCallback。
ヒント
アプリケーションで通知を使用するためには、名前付きキャッシュで通知を有効にする必要があります。 New-Cache
コマンドまたは Set-CacheConfig
コマンドで notificationsEnabled
パラメーターを使用してください。 詳細については、「PowerShell によるキャッシュ管理 (Velocity)」を参照してください。
nd パラメーターと共にデリゲート メソッドに渡される DataCacheNotificationDescriptor オブジェクトを使用すると、キャッシュ通知から購読解除することができます。 詳細については、「[HOWTO] キャッシュ通知コールバックを削除する (Velocity)」を参照してください。
プラットフォーム
開発プラットフォーム
Visual Studio 2010 およびそれ以降, .NET Framework 4
対象プラットフォーム
Windows 7; Windows Server 2008 R2; Windows Server 2008 Service Pack 2; Windows Vista Service Pack 2