DataCache.AddItemLevelCallback Method (String, DataCacheOperations, DataCacheNotificationCallback)

 

Adds a cache notification callback for cache operations occurring on one specific item that is not stored in a region. Not supported in Windows Azure Shared Caching.

Namespace:   Microsoft.ApplicationServer.Caching
Assembly:  Microsoft.ApplicationServer.Caching.Client (in Microsoft.ApplicationServer.Caching.Client.dll)

Syntax

public DataCacheNotificationDescriptor AddItemLevelCallback(
    string key,
    DataCacheOperations filter,
    DataCacheNotificationCallback clientCallback
)
public:
DataCacheNotificationDescriptor^ AddItemLevelCallback(
    String^ key,
    DataCacheOperations filter,
    DataCacheNotificationCallback^ clientCallback
)
member AddItemLevelCallback : 
        key:string *
        filter:DataCacheOperations *
        clientCallback:DataCacheNotificationCallback -> DataCacheNotificationDescriptor
Public Function AddItemLevelCallback (
    key As String,
    filter As DataCacheOperations,
    clientCallback As DataCacheNotificationCallback
) As DataCacheNotificationDescriptor

Parameters

  • key
    Type: System.String

    The key used to store the object in the cache.

Return Value

Type: Microsoft.ApplicationServer.Caching.DataCacheNotificationDescriptor

A DataCacheNotificationDescriptor object used to identify the cache notification callback.

Remarks

Only item operations AddItem, ReplaceItem, and RemoveItem can trigger cache notifications with item-level callbacks. Specifying region operations in the filter parameter will cause an exception.

Use the DataCacheOperations enumeration in the filter parameter to specify what type of item operations you want to trigger cache notifications. Select more than one enumeration by separating the enumerations with the binary OR operator to perform a bitwise OR. To do this, use the | character in C#, and the Or operator in Visual Basic.

The clientCallback method you invoke with the cache notification must accept the same parameters as the DataCacheNotificationCallback delegate.

Note

In order for your application to use notifications, you need to enable them on a named cache. For Windows Server AppFabric Caching, use the NotificationsEnabled parameter with the New-Cache or Set-CacheConfig Windows PowerShell commands. For Windows Azure Caching on roles, enable notifications in the cache settings.

See Also

AddItemLevelCallback Overload
DataCache Class
Microsoft.ApplicationServer.Caching Namespace

Return to top