Read (according to the modifiers) 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, ReadModifiers modifiers )
Function Read(Of T) ( _ template As T, _ tx As ITransaction, _ timeout As Long, _ modifiers As ReadModifiers _ ) As T
generic<typename T> T Read( T template, ITransaction^ tx, long long timeout, ReadModifiers modifiers )
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.
- modifiers (ReadModifiers)
- The modifier(s) to define behaviour of locks.
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. |