Insert list of CacheItem to the cache

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

Syntax

C#
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
)

Parameters

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

Return Value

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

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 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.
CopyC#
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
CopyC#
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