Region Destroy Method (CacheableKey)Pivotal GemFire .NET Client Documentation
Destroys the entry with the specified key, 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:

public void Destroy(
	CacheableKey key

GemStone.GemFire.Cache IllegalArgumentExceptionif 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 the 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 TimeoutException if the operation timed out
GemStone.GemFire.Cache RegionDestroyedException if this region has been destroyed

Destroy removes not only the value, but also the key and entry from this region.

The destroy is propogated to the Gemfire cache server to which it is connected with.

Does not update any CacheStatistics.

See Also