Share via


Tag-Based Methods

Microsoft AppFabric 1.1 for Windows Server 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 AppFabric Caching Logical Architecture Diagram (AppFabric 1.1 Caching).

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.

See Also

Concepts

Cache Notifications Methods
Class Overview
Basic Cache Methods
Concurrency Methods
Configuration Methods
Using Basic Cache Methods
AppFabric Caching Concepts (AppFabric 1.1 Caching)

  2012-09-12