Read any matching object from the space, returning null if there currently is none.
Equivalent to read, except that blocking is done only if necessary to wait for transactional state to settle.
![](../icons/collapse_all.gif)
C# | Visual Basic | Visual C++ | J# |
T ReadIfExists<T>( T template, ITransaction tx, long timeout )
Function ReadIfExists(Of T) ( _ template As T, _ tx As ITransaction, _ timeout As Long _ ) As T
generic<typename T> T ReadIfExists( T template, ITransaction^ tx, long long timeout )
![](../icons/collapse_all.gif)
- T
- Type of object to read.
![](../icons/collapse_all.gif)
- 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.
![](../icons/collapse_all.gif)
A copy of the object read from the space (null if no match was found).
![](../icons/collapse_all.gif)
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. |