Method UpdateAndReleaseExclusive
UpdateAndReleaseExclusive(TKey, TValue, LockToken, UpdatePolicy, IEnumerable<string>, CancellationToken)
Updates an existing object in the cache that is already locked by the caller and releases the lock on the object.
public CacheResponse<TKey, TValue> UpdateAndReleaseExclusive(TKey key, TValue value, LockToken lockToken, UpdatePolicy updatePolicy = null, IEnumerable<string> tags = null, CancellationToken cancellationToken = default)
Parameters
key
TKeyIdentifier of the object in the cache.
value
TValueValue to be stored in the cache.
lockToken
LockTokenA non-empty lock token that was acquired from an earlier locking call.
updatePolicy
UpdatePolicyPolicy changes to make to the object in the ScaleOut service. If null, the policy is left unchanged.
tags
IEnumerable<string>Collection of tags to associate with the object. All tags are replaced with the provided collection. Pass null to leave current tags in place. An empty collection clears current tags.
cancellationToken
CancellationTokenA token used to propagate notification that this operation should be canceled.
Returns
- CacheResponse<TKey, TValue>
A CacheResponse<TKey, TValue> containing the outcome of the operation.
Remarks
The Result property of the response will contain one of the following ServerResult outcomes:
ServerResult | Description |
---|---|
Updated | The object was successfully updated and unlocked in the ScaleOut service. |
NotFound | The requested object was not found in the ScaleOut service. |
LockLostError | The exclusive lock on the object was lost (typically due to a lock timeout) and another caller claimed it. |