Replaces an object in the cache if the provided object version matches
the version of object stored in the specified region.
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, DataCacheItemVersion oldVersion, 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. - oldVersion
- Type: Soss.Compat.WSAFDataCacheItemVersion
DataCacheItemVersion that represents the version of the cached object to be replaced. - 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
By passing the oldVersion parameter, this method can maintain concurrency. If another process updates the cached object before this method is called, this method does not update the cached object and returns null.
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.
See Also