Puts a new value into an entry in this region with the specified key in the local cache only, passing the callback argument to any cache writers and cache listeners that are invoked in the operation.

Namespace: GemStone.GemFire.Cache
Assembly:  GemStone.GemFire.Cache (in GemStone.GemFire.Cache.dll)
Version: 2.7.0.0

Syntax

C#
public void LocalPut(
	ICacheableKey key,
	IGFSerializable value,
	IGFSerializable callbackArg
)
Visual Basic (Declaration)
Public Sub LocalPut ( _
	key As ICacheableKey, _
	value As IGFSerializable, _
	callbackArg As IGFSerializable _
)
Visual C++
public:
void LocalPut (
	ICacheableKey^ key, 
	IGFSerializable^ value, 
	IGFSerializable^ callbackArg
)

Parameters

key
ICacheableKey
a key object associated with the value to be put into this region.
value
IGFSerializable
the value to be put into this region
callbackArg
IGFSerializable
argument that is passed to the callback functions

Remarks

If there is already an entry associated with the specified key in this region, the entry's previous value is overwritten.

Updates the LastAccessedTime and LastModifiedTime for this region and the entry.

Exceptions

ExceptionCondition
GemStone.GemFire.Cache..::IllegalArgumentException if key is null
GemStone.GemFire.Cache..::CacheWriterException if CacheWriter aborts the operation
GemStone.GemFire.Cache..::CacheListenerException if CacheListener throws an exception
GemStone.GemFire.Cache..::RegionDestroyedException if region has been destroyed
GemStone.GemFire.Cache..::OutOfMemoryException if there is not enough memory for the value

See Also