GigaSpaces XAP.NET Documentation
TakeIfExists<(Of <(T>)>) Method (query, tx, timeout, modifiers)
Class LibraryGigaSpaces.CoreISpaceProxyTakeIfExists<(Of <(T>)>)(IQuery<(Of <(T>)>), ITransaction, Int64, TakeModifiers)
Take any matching object from the space, returning null if there currently is none. Equivalent to take, except that blocking is done only if necessary to wait for transactional state to settle.
Declaration Syntax
C#Visual BasicVisual C++J#
T TakeIfExists<T>(
	IQuery<T> query,
	ITransaction tx,
	long timeout,
	TakeModifiers modifiers
)
Function TakeIfExists(Of T) ( _
	query As IQuery(Of T), _
	tx As ITransaction, _
	timeout As Long, _
	modifiers As TakeModifiers _
) As T
generic<typename T>
T TakeIfExists(
	IQuery<T>^ query, 
	ITransaction^ tx, 
	long long timeout, 
	TakeModifiers modifiers
)
J# supports the use of generic APIs, but not the declaration of new ones.
Generic Template Parameters
T
Type of object to read.
Parameters
query (IQuery<(Of <(T>)>))
The query used for matching.
tx (ITransaction)
The transaction (if any) under which to work.
timeout (Int64)
How long the client is willing to wait for a transactionally proper matching object.
modifiers (TakeModifiers)
The modifier(s) to define behaviour of the operation.
Return Value
The object taken from the space (null if no match was found).
Exceptions
ExceptionCondition
UnusableEntryExceptionA serialized field of the object being read cannot be deserialized.
TransactionExceptionTransaction error occured.
InactiveSpaceExceptionThe space is in backup mode and therefore is not active.
EntryVersionConflictExceptionOperation is rejected as a result of optimistic locking version conflict.
SqlQueryExceptionThe query template is an illegal SqlQuery.

Assembly: GigaSpaces.Core (Module: GigaSpaces.Core) Version: 10.2.0.0 (10.2.1.14000)