Remove Data with Named Tags From Data Cache

The items added with Named Tags to the data cache can also be removed from the data cache using the same Named Tags. Additionally, like updating Named Tags, they can also be removed via CacheItem. This is a custom class provided by NCache which can be used to add data to the data cache. To remove Named Tag via CacheItem, the Named Tagproperty of the CacheItem is set as null.

Prerequisites

To learn about the standard prerequisites required to work with all NCache client-side features, please refer to the given page on Client-Side API Prerequisites.
For API details, refer to: ICache, CacheItem, NamedTags, GetCacheItem, Insert, Remove.

The following example removes the Named Tags via CacheItem.

// Precondition: Cache is already connected
// A User wants to end the VIP membership discount offer
// So this Named Tag needs to be removed.

string customerKey = $"Customer:ALFKI";

// Retrieve the CacheItem using the key
CacheItem cacheItem = cache.GetCacheItem(customerKey);

// Remove tag from dictionary
cacheItem.NamedTags.Remove("VIP_Membership_Discount");

// Reinsert the cacheItem in the cache with Named Tags removed
cache.Insert(customerKey, cacheItem);

// Precondition: Cache is already connected
// A User wants to end the VIP membership discount offer
// So this Named Tag needs to be removed.

String customerKey = "Customer:ALFKI";

// Retrieve the CacheItem using the key
CacheItem cacheItem = cache.getCacheItem(customerKey);

// Remove tag from dictionary
cacheItem.getNamedTags().remove("VIP_Membership_Discount");

// Reinsert the cacheItem in the cache with Named Tags removed
cache.insert(customerKey, cacheItem);

// This is an async method
// Precondition: Cache is already connected
// CacheItem is already added in the cache with Named Tags with this key

var key = "Product:1001";

// Retrieve the CacheItem using the key
var cacheItem = await this.cache.getCacheItem(key);

// Set the Named Tags property of the cacheItem as null
cacheItem.setNamedTags(null);

// Re-insert the cacheItem in the cache with Named Tags removed
await this.cache.insert(key, cacheItem);

// CacheItem is successfully re-inserted in cache with removed Named Tags

# Precondition: Cache is already connected
# CacheItem is already added in the cache with Named Tags with this key

key = "Product:1001"

# Retrieve the CacheItem using the key
cache_item = cache.get_cacheitem(key)

# Set the Named Tags property of the cacheItem as null
cache_item.set_named_tags(None)

# Re-insert the cacheItem in the cache with Named Tags removed
cache.insert(key, cache_item)

# CacheItem is successfully re-inserted in cache with removed Named Tags

Note

To ensure the operation is fail-safe, it is recommended to handle any potential exceptions within your application, as explained in Handling Failures.

Note

The cacheItem.NamedTags.Remove(tagName) method will remove the Named Tag associated with the tag name tagName. If all Named Tags are removed from the Named Tags dictionary and the cache item is then inserted into the cache, Named Tags will be removed from that cache item since an empty Named Tags dictionary indicates no Named Tags.

Additional Resources

NCache provides a sample application for Tags on GitHub.

Remove Data with Named Tags From Data Cache

Prerequisites

Note

Note

Additional Resources

See also

Contact Us