Take (remove) 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# |
ITakeByIdsResult<Object> TakeByIds( Type type, Object[] ids, Object[] routingKeys, ITransaction tx, TakeModifiers modifiers )
Function TakeByIds ( _ type As Type, _ ids As Object(), _ routingKeys As Object(), _ tx As ITransaction, _ modifiers As TakeModifiers _ ) As ITakeByIdsResult(Of Object)
ITakeByIdsResult<Object^>^ TakeByIds( Type^ type, array<Object^>^ ids, array<Object^>^ routingKeys, ITransaction^ tx, TakeModifiers modifiers )
ITakeByIdsResult<Object> TakeByIds( Type type, Object[] ids, Object[] routingKeys, ITransaction tx, TakeModifiers 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 (TakeModifiers)
- The take modifier to use (One or several of ).
Return Value
An ITakeByIdsResult<(Of <(<'T>)>)> containing the matched results.
Exceptions
Exception | Condition |
---|---|
TakeByIdsException | The operation had a failure. |