DataCachePut Method (String, Object, DataCacheItemVersion, IEnumerableDataCacheTag)Windows Server AppFabric Caching Compatibility Library
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: DataCacheItemVersion
The DataCacheItemVersion object representing the version of the object after the Put operation completes, or null if there is a version mismatch.
Exceptions

ExceptionCondition
DataCacheExceptionthrown 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

Reference