SaveChangeWithChangeUnitsContext.DestinationVersionSuppliedForChange Property
Gets an ItemChange object that contains the original version that the destination provider supplied to the change applier.
Namespace: Microsoft.Synchronization
Assembly: Microsoft.Synchronization (in Microsoft.Synchronization.dll)
Syntax
'Declaration
Public ReadOnly Property DestinationVersionSuppliedForChange As ItemChange
Get
'Usage
Dim instance As SaveChangeWithChangeUnitsContext
Dim value As ItemChange
value = instance.DestinationVersionSuppliedForChange
public ItemChange DestinationVersionSuppliedForChange { get; }
public:
property ItemChange^ DestinationVersionSuppliedForChange {
ItemChange^ get ();
}
member DestinationVersionSuppliedForChange : ItemChange
function get DestinationVersionSuppliedForChange () : ItemChange
Property Value
Type: Microsoft.Synchronization.ItemChange
An ItemChange object that contains the original version that the destination provider supplied to the change applier.
Remarks
This property can be used to implement an optimistic concurrency check. To do this, the destination provider compares the version contained in the returned ItemChange object to the current version in its metadata. If the versions are not the same, the item has been changed on the destination replica between the time that the change application was started and the time INotifyingChangeApplierTarget.SaveChangeWithChangeUnits was called. If this occurs, the destination provider must report an error by using RecordRecoverableErrorForChangeUnit, and the metadata and item data for this change must not be applied. Be aware that this concurrency check is effective only if versions are updated in the metadata store before this concurrency check is performed, such as on a system on which versions are updated in the metadata store at the same time item changes are made in the item store.