Take (remove) objects from the space matching their IDs, the specified class and routing key.
Note, if routing key 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 routingKey, ITransaction tx )
Function TakeByIds ( _ type As Type, _ ids As Object(), _ routingKey As Object, _ tx As ITransaction _ ) As ITakeByIdsResult(Of Object)
ITakeByIdsResult<Object^>^ TakeByIds( Type^ type, array<Object^>^ ids, Object^ routingKey, ITransaction^ tx )
ITakeByIdsResult<Object> TakeByIds( Type type, Object[] ids, Object routingKey, ITransaction tx )
Parameters
- type (Type)
- The class.
- ids (array< Object >[]()[])
- The object IDs array.
- routingKey (Object)
- The routing key of the provided object IDs.
- tx (ITransaction)
- The transaction which this operation will participate in.
Return Value
An ITakeByIdsResult<(Of <(T>)>) containing the matched results.
Exceptions
Exception | Condition |
---|---|
TakeByIdsException | The operation had a failure. |