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: 2.5.0.1

Syntax

C#
public IGFSerializable SelectValue(
	string predicate,
	uint timeout
)
Visual Basic (Declaration)
Public Function SelectValue ( _
	predicate As String, _
	timeout As UInteger _
) As IGFSerializable
Visual C++
public:
IGFSerializable^ SelectValue (
	String^ predicate, 
	unsigned int timeout
)

Parameters

predicate
String
The query predicate (just the WHERE clause) or the entire query to execute
timeout
UInt32
The time (in seconds) to wait for the query response

Return Value

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

Exceptions

ExceptionCondition
GemStone.GemFire.Cache..::IllegalArgumentException If the predicate is empty.
GemStone.GemFire.Cache..::IllegalStateException If some error occurred.
GemStone.GemFire.Cache..::CacheServerException If an exception is received from the Java cache server.
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.
GemStone.GemFire.Cache..::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.
GemStone.GemFire.Cache..::QueryException If some query error occurred at the server, or more than one result items are available.
GemStone.GemFire.Cache..::TimeoutException if the operation timed out
GemStone.GemFire.Cache..::CacheClosedException if the cache has been closed

See Also