Creates a new entry in this region with the specified key and value, passing the callback argument to any cache writers that are invoked in the operation.

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

Syntax

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

Parameters

key
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
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.
cacheWriterArg
IGFSerializable
a user-defined parameter to pass to the CacheWriter

Remarks

@cacheserver

If this region has a distributed scope, then the value may be updated subsequently if other caches update the value.

@endcacheserver

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

@cacheserver

If this region has a distributed scope, this operation may cause update events in caches that already have this region with this entry, and it will cause create events in other caches that have this region mirrored.

@endcacheserver @nativeclient

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

@endnativeclient

Exceptions

ExceptionCondition
GemStone.GemFire.Cache..::IllegalArgumentException if key is null
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.
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

See Also