Take (remove) 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# |
ITakeByIdsResult<Object> TakeByIds( Type type, Object[] ids, Object[] routingKeys )
Function TakeByIds ( _ type As Type, _ ids As Object(), _ routingKeys As Object() _ ) As ITakeByIdsResult(Of Object)
ITakeByIdsResult<Object^>^ TakeByIds( Type^ type, array<Object^>^ ids, array<Object^>^ routingKeys )
ITakeByIdsResult<Object> TakeByIds( Type type, Object[] ids, Object[] routingKeys )
Parameters
- type (Type)
- The class.
- ids (array<Object>[]()[][])
- The object IDs array.
- routingKeys (array<Object>[]()[][])
- The object routing keys array.
Return Value
An ITakeByIdsResult<(Of <(<'T>)>)> containing the matched results.
Exceptions
Exception | Condition |
---|---|
TakeByIdsException | The operation had a failure. |