Read objects from the space matching their IDs, the specified class and the routing keys.
Note, the IDs array and routing keys array are correlated and should be of the same size. The routing key of ID i in the IDs array is the element at position i in the routing keys array. If routingKeys is null and the cluster is partitioned, the operation will broadcast to all of the partitions.
FIFO is not supported by this operation - the results are always ordered in correlation with the input IDs array.
Declaration Syntax
C# | Visual Basic | Visual C++ | J# |
IReadByIdsResult<T> ReadByIds<T>( Object[] ids, Object[] routingKeys, ITransaction tx )
Function ReadByIds(Of T) ( _ ids As Object(), _ routingKeys As Object(), _ tx As ITransaction _ ) As IReadByIdsResult(Of T)
generic<typename T> IReadByIdsResult<T>^ ReadByIds( array<Object^>^ ids, array<Object^>^ routingKeys, ITransaction^ tx )
Generic Template Parameters
- T
- The class.
Parameters
- ids (array<Object>[]()[][])
- The object IDs array.
- routingKeys (array<Object>[]()[][])
- The object routing keys array.
- tx (ITransaction)
- The transaction which this operation will participate in.
Return Value
An IReadByIdsResult<(Of <(<'T>)>)> containing the matched results.
Exceptions
Exception | Condition |
---|---|
ReadByIdsException | The operation had a failure. |