Method Add

Add(String, Object)

Adds an item into the cache with a cache key to reference its location.

Declaration
CacheItemVersion Add(string key, object value)
Parameters
Type Name Description
System.String key

Unique key to identify the cache item.
System.Object value

The item (object) to be stored in the cache.
Returns
Type Description
CacheItemVersion

Represents the version of each cache item.
Examples

The following example demonstrates how to add a value to cache.

ICache cache = CacheManager.GetCache("demoClusteredCache");

Product product = new Product();
product.Id = 1;
product.Name = "Chai";

string key = "Product0";

cache.Add(key, product);

Add(String, CacheItem, WriteThruOptions)

Adds a CacheItem to the cache. It also lets you specify the WriteThruOptions. Using CacheItem, you can also specify properties for the cache items, for e.g., expiration and priority.

Declaration
CacheItemVersion Add(string key, CacheItem item, WriteThruOptions writeThruOptions = null)
Parameters
Type Name Description
System.String key

Unique key to identify the cache item.
CacheItem item

CacheItem that is to be stored in the cache.
WriteThruOptions writeThruOptions

WriteThruOptions regarding updating the data source. This can be either WriteThru, WriteBehind or none.
Returns
Type Description
CacheItemVersion

Represents the version of each cache item.
Remarks

If CacheItem contains invalid values, the related exception is thrown. See CacheItem for invalid property values and related exceptions.

Examples

The following example demonstrates how to add an item to the cache with a sliding expiration of 5 minutes and a high priority.

ICache cache = CacheManager.GetCache("demoClusteredCache");

Product product = new Product();
product.Id = 1;
product.Name = "Chai";

CacheItem item = new CacheItem(product);
item.Expiration = new Expiration(ExpirationType.Sliding,new TimeSpan(0, 5, 0));
item.Priority = CacheItemPriority.High;

string key = "Product0";

WriteThruOptions writeThruOptions = new WriteThruOptions(WriteMode.WriteThru, "ProdDataSource1");

cache.Add(key, item, writeThruOptions);