Insert list of CacheItem to the cache

Namespace: Alachisoft.NCache.Web.Caching
Assembly: Alachisoft.NCache.Web (in Alachisoft.NCache.Web.dll) Version: (


protected internal virtual IDictionary InsertBulkOperation(
	string[] keys,
	CacheItem[] items,
	DSWriteOption dsWriteOption,
	DataSourceItemsUpdatedCallback onDataSourceItemUpdatedCallback,
	string providerName
Visual Basic
Protected Friend Overridable Function InsertBulkOperation ( _
	keys As String(), _
	items As CacheItem(), _
	dsWriteOption As DSWriteOption, _
	onDataSourceItemUpdatedCallback As DataSourceItemsUpdatedCallback, _
	providerName As String _
) As IDictionary
Visual C++
protected public:
virtual IDictionary^ InsertBulkOperation(
	array<String^>^ keys, 
	array<CacheItem^>^ items, 
	DSWriteOption dsWriteOption, 
	DataSourceItemsUpdatedCallback^ onDataSourceItemUpdatedCallback, 
	String^ providerName


Type: array<System..::..String>[]()[][]
The cache keys used to reference the items.
Type: array<Alachisoft.NCache.Web.Caching..::..CacheItem>[]()[][]
The items that are to be stored
Type: Alachisoft.NCache.Web.Caching..::..DSWriteOption
Options regarding updating data source
Type: Alachisoft.NCache.Web.Caching..::..DataSourceItemsUpdatedCallback
A delegate that, if provided, is called when item is updated in data source.
Type: System..::..String

Return Value

returns keys that are added or updated successfully and their status.


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


The following example demonstrates how to assign an item high priority when you insert it into your application's Cache object.

Note: For more information about how to use this method with the CacheItemRemovedCallback delegate, see CacheItemRemovedCallback.

First create CacheItems.
string[] keys = {"SQLDSN", "ORADSN"};
CacheItem items[] = new CacheItem[2];
items[0] = new CacheItem(sqlConnectionString);
item.AbsoluteExpiration = DateTime.Now.AddMinutes(2);
item.Priority = CacheItemPriority.High;
item.ItemRemoveCallback = onRemove;

items[1] = new CacheItem(oraConnectionString);
item.AbsoluteExpiration = DateTime.Now.AddMinutes(1);
item.Priority = CacheItemPriority.Low;
item.ItemRemoveCallback = onRemove;
Then insert CacheItems to the cache
Cache cache = NCache.InitializeCache("myCache");
string[] keys = new string[] { "myItem1", "myItem2" };
CacheItem[] items = new CacheItem[]{myItem1, myItem2};
cache.Insert(keys, items, "Connection", null);

See Also