Adds or replaces an object in the cache with a new value and the specified collection of tags.
Namespace: Soss.Compat.WSAF
Assembly: soss_wsaf_compat (in soss_wsaf_compat.dll) Version: 1.1.0.100 (1.1.0.100)
Syntax
public DataCacheItemVersion Put( string key, Object value, IEnumerable<DataCacheTag> tags )
Parameters
- key
- Type: SystemString
The unique identifier used to access the object in the cache. - value
- Type: SystemObject
The object to add or replace in the cache. - tags
- Type: System.Collections.GenericIEnumerableDataCacheTag
List of DataCacheTag objects associated with the cached object.
Return Value
Type: DataCacheItemVersionThe DataCacheItemVersion object representing the version of the object after the Put operation completes, or null if there is a version mismatch.
Exceptions
Exception | Condition |
---|---|
DataCacheException | thrown if the WSAF Caching Compatibility Library is used with ScaleOut StateServer older than version 5.3 and object to update does not exist in the cache. |
Remarks
Tags may only be used to retrieve a cached object if that object is stored in a region. This overload does not save the object to a region and tags can simply be used as object's metadata.
This overload can be used for updating the tags associated with the cached object.
See Also