Region Create Method (CacheableKey, Serializable, IGFSerializable)Pivotal GemFire .NET Client Documentation
Creates a new entry in this region with the specified key and value, 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: 8.1.0.0
Syntax

public void Create(
	CacheableKey key,
	Serializable value,
	IGFSerializable callbackArg
)

Parameters

key
Type: GemStone.GemFire.Cache CacheableKey
The key for which to create the entry in this region. The object is created before the call, and the caller should not deallocate the object.
value
Type: GemStone.GemFire.Cache Serializable
The value for the new entry, which may be null to indicate that the new entry starts as if it had been locally invalidated.
callbackArg
Type: GemStone.GemFire.Cache IGFSerializable
a custome parameter to pass to the cache writer or cache listener
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 CacheServerException If an exception is received from the Java cache server. Only for Native Client regions.
GemStone.GemFire.Cache NotConnectedException if not connected to a GemFire system because the client cannot establish usable connections to any of the servers given to it. For pools configured with locators, if no locators are available, innerException of NotConnectedException is set to NoAvailableLocatorsException.
GemStone.GemFire.Cache RegionDestroyedException if region has been destroyed
GemStone.GemFire.Cache TimeoutException if the operation timed out
GemStone.GemFire.Cache OutOfMemoryException if there is not enough memory for the new entry
GemStone.GemFire.Cache EntryExistsException if an entry with this key already exists
Remarks

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

The new entry is propogated to the java server to which it is connected with.

If remote server put fails throwing back a CacheServerException or security exception, then local put is tried to rollback. However, if the entry has overflowed/evicted/expired then the rollback is aborted since it may be due to a more recent notification or update by another thread.

See Also