Method Add
Add(String, Object)
Adds an item into the Cache object 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
Example demonstrates how to add a value to cache.
ICache cache = CacheManager.GetCache("myCache");
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 |
Remarks
If CacheItem contains invalid values, the related exception is thrown. See CacheItem for invalid property values and related exceptions.
Examples
Example demonstrates how to add an item to the cache with a sliding expiration of 5 minutes, a priority of high.
ICache cache = CacheManager.GetCache("myCache");
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);