Assembly: GemStone.GemFire.Cache (in GemStone.GemFire.Cache.dll) Version: 126.96.36.199
public void Create( CacheableKey key, IGFSerializable value )
Public Sub Create ( _ key As CacheableKey, _ value As IGFSerializable _ )
public: void Create( CacheableKey^ key, IGFSerializable^ value )
- 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.
- Type: GemStone.GemFire.Cache IGFSerializable
The value for the new entry, which may be null to indicate that the new entry starts as if it had been locally invalidated.
|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|
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.