Insert list of CacheItem to the cache

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

Syntax

C#
public virtual IDictionary InsertBulk(
	string[] keys,
	CacheItem[] items,
	DSWriteOption dsWriteOption,
	string providerName,
	DataSourceItemsUpdatedCallback onDataSourceItemUpdatedCallback
)
Visual Basic
Public Overridable Function InsertBulk ( 
	keys As String(),
	items As CacheItem(),
	dsWriteOption As DSWriteOption,
	providerName As String,
	onDataSourceItemUpdatedCallback As DataSourceItemsUpdatedCallback
) As IDictionary
Visual C++
public:
virtual IDictionary^ InsertBulk(
	array<String^>^ keys, 
	array<CacheItem^>^ items, 
	DSWriteOption dsWriteOption, 
	String^ providerName, 
	DataSourceItemsUpdatedCallback^ onDataSourceItemUpdatedCallback
)

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
providerName
Type: System..::..String
A unique identifier for the data source
onDataSourceItemUpdatedCallback
Type: Alachisoft.NCache.Web.Caching..::..DataSourceItemsUpdatedCallback
A delegate that, if provided, is called when item is updated in data source.

Return Value

Type: IDictionary
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.
 Copy imageCopy
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
 Copy imageCopy
Cache cache = NCache.InitializeCache("myCache");
string[] keys = new string[]{"myItem1", "myItem2"};
CacheItem[] items = new CacheItem[]{myItem1, myItem2};
cache.InsertBulk(keys, items, DSWriteOption.WriteThru, providerName, new DataSourceItemsUpdatedCallback(onDSItemsUpdated));

See Also