Region.SelectValue Method (String)

RegionSelectValue Method (String)

Executes the query on the server based on the predicate and returns a single result value. Valid only for a Native Client region.

Namespace: GemStone.GemFire.Cache
Assembly: Gemstone.Gemfire.Cache (in Gemstone.Gemfire.Cache.dll) Version: 9.0.6.18

Syntax

public IGFSerializable SelectValue(
	string predicate
)

Public Function SelectValue ( 
	predicate As String
) As IGFSerializable

public:
IGFSerializable^ SelectValue(
	String^ predicate
)

member SelectValue : 
        predicate : string -> IGFSerializable

predicate: Type: SystemString
The query predicate (just the WHERE clause) or the entire query to execute

Type: IGFSerializable
The single ResultSet or StructSet item, or NULL of no results are available.

Exceptions

Exception	Condition
IllegalArgumentException	If the predicate is empty.
IllegalStateException	If some error occurred.
CacheServerException	If an exception is received from the Java cache server.
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.
MessageException	If the message received from server could not be handled. This will be the case when an unregistered typeId is received in the reply or reply is not well formed. More information can be found in the log.
QueryException	If some query error occurred at the server, or more than one result items are available.
TimeoutException	if the operation timed out
CacheClosedException	if the cache has been closed