Method InsertAsync

InsertAsync(String, Object)

Inserts an object into the cache asynchronously with a cache key to reference its location.

Declaration

Task<CacheItemVersion> InsertAsync(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
System.Threading.Tasks.Task<CacheItemVersion>	Task that performs an insert operation in the background. Once completed returns version of cache item that was added in cache. Task Status property can be used to determine status of the task that can be IsCanceled, IsCompleted, and IsFaulted.

Remarks

If the key already exists, this overload overwrites the values of the existing ICache item. If the key does not exist, it adds the item to the cache.

Examples

Example demonstrates how to add an object to the cache asynchronously with registering a Task to monitor the status of the operation.

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

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

string key = "Product0";

cache.InsertAsync(key, product).ContinueWith(task => OnItemInserted(key, task));

private static void OnItemInserted(string key, Task<CacheItemVersion> task)
{
    if (task.Status == TaskStatus.RanToCompletion)
    {
    ...
    }
    if (task.Status == TaskStatus.Faulted)
    {
    ...
    }
    if (task.Exception != null)
    {
    ...
    }
}

InsertAsync(String, CacheItem, WriteThruOptions)

Inserts a CacheItem into the cache asynchronously with a cache key to reference its location and WriteThruOptions.

Declaration

Task<CacheItemVersion> InsertAsync(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
System.Threading.Tasks.Task<CacheItemVersion>	Task that performs an insert operation in the background. Once completed returns version of cache item that was added in cache. Task Status property can be used to determine status of the task that can be IsCanceled, IsCompleted, and IsFaulted.

Examples

Example demonstrates how to add an CacheItem to the cache asynchronously with registering a Task to monitor the status of the operation along with WriteThruOptions.

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

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

CacheItem item = new CacheItem(product);

string key = "Product0";

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

cache.InsertAsync(key, item, writeThruOptions).ContinueWith(task => OnItemInserted(key, task));

private static void OnItemInserted(string key, Task<CacheItemVersion> task)
{
    if (task.Status == TaskStatus.RanToCompletion)
    {
    ...
    }
    if (task.Status == TaskStatus.Faulted)
    {
    ...
    }
    if (task.Exception != null)
    {
    ...
    }
}