Read any matching object from the space, blocking until one exists. Return null if the timeout expires.
Declaration Syntax
C# | Visual Basic | Visual C++ | J# |
T Read<T>( T template, ITransaction tx, long timeout )
Function Read(Of T) ( _ template As T, _ tx As ITransaction, _ timeout As Long _ ) As T
generic<typename T> T Read( T template, ITransaction^ tx, long long timeout )
Generic Template Parameters
- T
- Type of object to read.
Parameters
- template (T)
- The template 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.
Return Value
A copy of the object read from the space (null if no match was found).
Exceptions
Exception | Condition |
---|---|
UnusableEntryException | A serialized field of the object being read cannot be deserialized. |
TransactionException | Transaction error occured. |
InactiveSpaceException | The space is in backup mode and therefore is not active. |