Tag-Based Methods (Windows Server AppFabric Caching)

Article
09/20/2010

Windows Server AppFabric supports organizing and retrieving cached objects that use tags. Tags allow you to add one or more strings to describe each cached object. These tags simplify code by letting you retrieve groups of objects based on matching tags.

Note

Tags can only be used with objects stored in regions. For more information about regions, see Windows Server AppFabric Caching Logical Architecture Diagram.

The following table lists the methods available for working with tags.

Method	Description
GetObjectsByTag	Provides a simple way to access objects that contain tags (exact match, intersection, or union). The region name is a required parameter.
GetObjectsByAnyTag	Returns a list of objects that have tags matching any of the tags provided in the parameter of this method.
GetObjectsByAllTags	Returns a list of objects that have tags matching all of the tags provided in the parameter of this method.
GetObjectsInRegion	Returns a list of all objects in a region. This method is useful when you do not know all the tags used in the region.
GetCacheItem	Returns a DataCacheItem object. In addition to the cached object and other information associated with the cached object, the DataCacheItem object also includes the associated tags.
Add	When adding an object to cache, this method supports associating tags with that item in the cache.
Put	When putting an object into cache, this method can be used to replace tags associated with a cached object.
Remove	This method deletes the cached object and any associated tags.

Note

Updates or deletes on individual tags associated with a cached object are not supported. To make changes, all tags must be replaced.

Tag-Based Methods (Windows Server AppFabric Caching)

See Also

Concepts

Additional resources