Invalidates this region.

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

Syntax

C#
void InvalidateRegion(
	Object callbackArg
)
Visual Basic (Declaration)
Sub InvalidateRegion ( _
	callbackArg As Object _
)
Visual C++
void InvalidateRegion (
	Object^ callbackArg
)

Parameters

callbackArg
Object
user-defined parameter to pass to callback events triggered by this method

Remarks

The invalidation will cascade to all the subregions and cached entries. The region and the entries in it will still exist. For local region instance - invalidates this region without distributing to other caches. For distributed region instance - Invalidates this region and this operation is propogated to the Gemfire cache server to which it is connected with.

To remove all the entries and the region, use DestroyRegion()().

Does not update any CacheStatistics.

Exceptions

ExceptionCondition
GemStone.GemFire.Cache.Generic..::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.Generic..::RegionDestroyedException if this region has been destroyed
GemStone.GemFire.Cache.Generic..::CacheListenerException if CacheListener throws an exception; if this occurs some subregions may have already been successfully invalidated

See Also