Read objects from the space matching their IDs, the specified class and the routing keys, with the
provided .
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<Object> ReadByIds( Type type, Object[] ids, Object[] routingKeys, ITransaction tx, ReadModifiers modifiers )
Function ReadByIds ( _ type As Type, _ ids As Object(), _ routingKeys As Object(), _ tx As ITransaction, _ modifiers As ReadModifiers _ ) As IReadByIdsResult(Of Object)
IReadByIdsResult<Object^>^ ReadByIds( Type^ type, array<Object^>^ ids, array<Object^>^ routingKeys, ITransaction^ tx, ReadModifiers modifiers )
IReadByIdsResult<Object> ReadByIds( Type type, Object[] ids, Object[] routingKeys, ITransaction tx, ReadModifiers modifiers )
Parameters
- type (Type)
- The class type.
- 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.
- modifiers (ReadModifiers)
- The read modifier to use (One or several of ).
Return Value
An IReadByIdsResult<(Of <(T>)>) containing the matched results.
Exceptions
Exception | Condition |
---|---|
ReadByIdsException | The operation had a failure. |