RetrieveOptions Constructor (ReadLockingMode, GeoServerReadMode, CreateHandler, Object, CreatePolicy)

ScaleOut Software NamedCache API
Constructor

Namespace:  Soss.Client
Assembly:  soss_namedcache (in soss_namedcache.dll) Version: 6.1.0.0
Syntax

public RetrieveOptions(
	ReadLockingMode lockingMode,
	GeoServerReadMode geoServerReadMode,
	CreateHandler createHandler,
	Object createArgument,
	CreatePolicy createPolicy
)

Parameters

lockingMode
Type: Soss.ClientReadLockingMode
Determines whether the Retrieve method should attempt to acquire a StateServer lock when reading the object.
geoServerReadMode
Type: Soss.ClientGeoServerReadMode
Determines GeoServer "pull" replication behavior when retrieving the object from the StateServer.
createHandler
Type: Soss.ClientCreateHandler
The optional, custom object creation callback to use when an attempt is made to retrieve an object that is not in the cache. If this callback is non-null then it will override any existing read-though backing store behavior that was specified at the named cache level through the SetBackingStoreAdapter(IBackingStore, BackingStorePolicy) method.
createArgument
Type: SystemObject
An argument that will be passed to the provided createHandler callback if a missing object is to be created. Null is allowed.
createPolicy
Type: Soss.ClientCreatePolicy
A cache policy object to be used when a Retrieve(String, RetrieveOptions) operation is configured to transparently insert a missing object into the named cache using createHandler. If null, the object will fall back to using the policy specified at the named cache level through the SetBackingStoreAdapter(IBackingStore, BackingStorePolicy) method (as implemented in an GetCreatePolicy(CachedObjectId) implementation). If no IBackingStore implementation is associated with the NamedCache (or if GetCreatePolicy(CachedObjectId) returns null), the object will then fall back to using the policy specified in the named cache's DefaultCreatePolicy property.
See Also

Reference