Changes an existing object in space, returning a change result which provides details of the operation affect.
The change operation is designed for performance optimization, By allowing to change an existing object unlike
with regular updating write operation which usually requires reading the object before applying to update to it.
As part of the optimization, when the operation is replicated, on a best effort it will
try to replicate only the required data which is needed to apply the changes on the entry in the replicated target.
Modifiers can be used to specify behavior of the change operation, by default uses the None modifier.
Declaration Syntax
C# | Visual Basic | Visual C++ | J# |
IChangeResult<T> Change<T>( IQuery<T> query, ChangeSet changeSet, ITransaction tx, long timeout )
Function Change(Of T) ( _ query As IQuery(Of T), _ changeSet As ChangeSet, _ tx As ITransaction, _ timeout As Long _ ) As IChangeResult(Of T)
generic<typename T> IChangeResult<T>^ Change( IQuery<T>^ query, ChangeSet^ changeSet, ITransaction^ tx, long long timeout )
Generic Template Parameters
- T
- Type of object to change.
Parameters
- query (IQuery<(Of <(<'T>)>)>)
- Query to search by.
- changeSet (ChangeSet)
- Changes to apply to the matched entry.
- tx (ITransaction)
- The transaction (if any) under which to work.
- timeout (Int64)
- The timeout of the operation, in milliseconds. If the entry is locked by another transaction wait for the specified number of milliseconds for it to be released.
Return Value
A IChangeResult<(Of <(<'T>)>)> containing the details of the change operation affect.