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>( T template, ChangeSet changeSet, ITransaction tx )
Function Change(Of T) ( _ template As T, _ changeSet As ChangeSet, _ tx As ITransaction _ ) As IChangeResult(Of T)
generic<typename T> IChangeResult<T>^ Change( T template, ChangeSet^ changeSet, ITransaction^ tx )
Generic Template Parameters
- T
- Type of object to change.
Parameters
- template (T)
- Query to search by.
- changeSet (ChangeSet)
- Changes to apply to the matched entry.
- tx (ITransaction)
- The transaction (if any) under which to work.
Return Value
A IChangeResult<(Of <(<'T>)>)> containing the details of the change operation affect.