Add a CacheItem to the cache
Namespace: Alachisoft.NCache.Web.CachingAssembly: Alachisoft.NCache.Web (in Alachisoft.NCache.Web.dll) Version: 4.1.0.0 (4.1.0.0)
Syntax
C# |
---|
public CacheItemVersion Add( string key, CacheItem item, DSWriteOption dsWriteOption, DataSourceItemsAddedCallback onDataSourceItemAdded ) |
Visual Basic |
---|
Public Function Add ( _ key As String, _ item As CacheItem, _ dsWriteOption As DSWriteOption, _ onDataSourceItemAdded As DataSourceItemsAddedCallback _ ) As CacheItemVersion |
Visual C++ |
---|
public: CacheItemVersion^ Add( String^ key, CacheItem^ item, DSWriteOption dsWriteOption, DataSourceItemsAddedCallback^ onDataSourceItemAdded ) |
Parameters
- key
- Type: System..::..String
The cache key used to reference the item.
- item
- Type: Alachisoft.NCache.Web.Caching..::..CacheItem
The item that is to be stored
- dsWriteOption
- Type: Alachisoft.NCache.Web.Caching..::..DSWriteOption
Options regarding updating data source
- onDataSourceItemAdded
- Type: Alachisoft.NCache.Web.Caching..::..DataSourceItemsAddedCallback
A delegate that, if provided, is called when item is added to data source.
Return Value
An instance of CacheItemVersionRemarks
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 add an item to the cache with an absolute
expiration of 2 minutes from now, a priority of high, and that notifies the application when the item is removed from the cache.
First create a CacheItem.
Then add CacheItem to the cache
CopyC#
object someData = new object(); CacheItem item = new CacheItem(someData); item.AbsoluteExpiration = DateTime.Now.AddMinutes(2); item.Priority = CacheItemPriority.High; item.ItemRemoveCallback = onRemove;
CopyC#
OnDataSourceItemAdded(IDictionary result) { ... } Cache cache = NCache.InitializeCache("myCache"); cache.Add("someData", item, DSWriteOption.WriteBehind, new DataSourceItemsAddedCallback(OnDataSourceItemAdded));