Replaces an object in the specified region if the provided object version matches
the version of object stored in the cache.
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, string region )
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. - region
- Type: SystemString
The name of the region where the object will be stored.
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.
See Also