Creates a new entry in this region with the specified key and value 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.1

Syntax

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

Parameters

key
CacheableKey
the key object for which to create the entry in this region.
value
Serializable
the value to be created in 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, then an EntryExistsException is thrown.

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

Exceptions

ExceptionCondition
GemStone.GemFire.Cache..::IllegalArgumentException if key is null
GemStone.GemFire.Cache..::EntryExistsException if an entry with this key already exists
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