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

Change History

関連項目

参照

Microsoft.ApplicationServer.Caching 名前空間