Destroys the whole distributed region and provides a user-defined parameter object to any ICacheWriter invoked in the process.

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


public void DestroyRegion()
Visual Basic (Declaration)
Public Sub DestroyRegion
Visual C++
void DestroyRegion ()


Destroy cascades to all entries and subregions. After the destroy, this region object can not be used any more. Any attempt to use this region object will get a RegionDestroyedException The region destroy not only destroys the local region but also destroys the server region.

Does not update any CacheStatistics.


GemStone.GemFire.Cache..::CacheWriterException if a CacheWriter aborts the operation; if this occurs some subregions may have already been successfully destroyed.
GemStone.GemFire.Cache..::CacheListenerException if CacheListener throws an exception; if this occurs some subregions may have already been successfully invalidated
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

See Also