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<T> TakeByIds<T>( Object[] ids, Object[] routingKeys, ITransaction tx, TakeModifiers modifiers )
Function TakeByIds(Of T) ( _ ids As Object(), _ routingKeys As Object(), _ tx As ITransaction, _ modifiers As TakeModifiers _ ) As ITakeByIdsResult(Of T)
generic<typename T> ITakeByIdsResult<T>^ TakeByIds( array<Object^>^ ids, array<Object^>^ routingKeys, ITransaction^ tx, TakeModifiers modifiers )
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.
- 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. |