SALES: 1-800-867-1380

Cache API Support in Azure Cache

Updated: July 17, 2010

noteNote
For guidance on choosing the right Azure Cache offering for your application, see Which Azure Cache offering is right for me?.

Microsoft Azure Cache and Microsoft AppFabric 1.1 for Windows Server share a common API set for working with caches, but there are some differences between the two. This topic provides an overview of the API differences between Microsoft Azure Cache and on-premise Microsoft AppFabric 1.1 for Windows Server. For more information on caching concepts that differ between on-premises and in the cloud, see Differences Between Caching On-Premises and in the Cloud.

The following information provides more details on the support for specific APIs in the SDK.

API Support in Azure Caching

Microsoft Azure Cache comes in two flavors: Microsoft Azure Shared Caching and In-Role Cache on roles. Shared Caching is the multitenant cache offering that provides several caching tiers from 128 MB to 4 GB. In addition to memory and cost differences, each tier varies in other resource quotas such as bandwidth, transactions, and client connections. In-Role Cache on roles provides caching by using a portion of the memory from the virtual machines instances for the role that hosts In-Role Cache. Role-based In-Role Cache supports more of the caching APIs than Shared Caching.

noteNote
For more information on Shared Caching and In-Role Cache, see About Azure Shared Caching and About In-Role Cache for Azure Cache.

The following table provides support information for caching classes, properties, or methods. These items are highlighted because they have a supportability note for either Shared Caching or role-based In-Role Cache. In many cases, an unsupported item in Shared Caching is supported in In-Role Cache on roles. The classes, properties, and methods listed in the following table are in the Microsoft.ApplicationServer.Caching namespace.

 

API Shared Caching Role-based In-Role Cache

DataCache.AddCacheLevelBulkCallback

Not supported

Supported

DataCache.AddCacheLevelCallback

Not supported

Supported

DataCache.AddCacheLevelCallback

Not supported

Supported

DataCache.AddItemLevelCallback

Not supported

Supported

DataCache.AddRegionLevelCallback

Not supported

Supported

DataCache.ClearRegion

Not supported

Supported

DataCache.CreateRegion

Not supported

Supported

DataCache.GetObjectsByAllTags

Not supported

Supported

DataCache.GetObjectsByAnyTag

Not supported

Supported

DataCache.GetObjectsByTag

Not supported

Supported

DataCache.GetObjectsInRegion

Not supported

Supported

DataCache.GetSystemRegionName

Not supported

Supported

DataCache.GetSystemRegions

Not supported

Supported

DataCache.RemoveCallback

Not supported

Supported

DataCache.RemoveRegion

Not supported

Supported

DataCacheFactory.GetCache

Partial - Named caches are not supported, so the only valid parameter to this method is default.

Supported

DataCacheLocalCacheProperties constructor

Partial - The DataCacheLocalCacheInvalidationPolicy class must be set to TimeoutBased. Notifications are not supported.

Supported

DataCacheNotificationProperties class

Not supported

Supported

DataCacheOperationDescriptor class

Not supported

Supported

DataCacheSecurity constructor

Use the constructor overload that takes a single string value of the ACS key. The ACS key is obtained during provisioning.

Not required

ICustomProvider interface

Not supported

Not supported

DataCacheStoreProvider class

Read-through and write-behind are not supported.

Read-through and write-behind are not supported.

ImportantImportant
The previous list highlights the most important differences in the API, but it is not exhaustive. For example, there are many methods that have an overload which takes a region parameter. These overloads are not supported for Shared Caching; although in this example, these overloads are supported on role-based In-Role Cache.

See Also

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft