Registers a collection of keys for getting updates from the server. Valid only for a Native Client region when client notification ( SetClientNotificationEnabled(Boolean) ) is true. Should only be called for durable clients and with cache server version 5.5 onwards.

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

Syntax

C#
void RegisterKeys(
	ICollection<TKey> keys,
	bool isDurable,
	bool getInitialValues,
	bool receiveValues
)
Visual Basic (Declaration)
Sub RegisterKeys ( _
	keys As ICollection(Of TKey), _
	isDurable As Boolean, _
	getInitialValues As Boolean, _
	receiveValues As Boolean _
)
Visual C++
void RegisterKeys (
	ICollection<TKey>^ keys, 
	bool isDurable, 
	bool getInitialValues, 
	bool receiveValues
)

Parameters

keys
ICollection<(Of <TKey>)>
a collection of keys
isDurable
Boolean
whether the registration should be durable
getInitialValues
Boolean
true to populate the cache with values of the keys that were registered on the server
receiveValues
Boolean
whether to act like notify-by-subscription is true

Exceptions

ExceptionCondition
GemStone.GemFire.Cache.Generic..::IllegalArgumentException If the collection of keys is empty.
GemStone.GemFire.Cache.Generic..::IllegalStateException If already registered interest for all keys.
GemStone.GemFire.Cache.Generic..::CacheServerException If an exception is received from the Java cache server.
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.
GemStone.GemFire.Cache.Generic..::RegionDestroyedException If region destroy is pending.
GemStone.GemFire.Cache.Generic..::UnsupportedOperationException If the region is not a Native Client region or SetClientNotificationEnabled(Boolean) is false.
GemStone.GemFire.Cache.Generic..::TimeoutException if the operation timed out
GemStone.GemFire.Cache.Generic..::UnknownExceptionFor other exceptions.

See Also