SaveChangeAction Enumeration
Represents the type of action that is indicated by a change.
Namespace: Microsoft.Synchronization
Assembly: Microsoft.Synchronization (in microsoft.synchronization.dll)
Syntax
'Declaration
Public Enumeration SaveChangeAction
'Usage
Dim instance As SaveChangeAction
public enum SaveChangeAction
public enum class SaveChangeAction
public enum SaveChangeAction
public enum SaveChangeAction
Members
| Member name | Description | |
|---|---|---|
| Create | The item is new and is created in the destination item store. | |
| DeleteAndRemoveTombstone | The item is deleted from the destination item store. A tombstone is not retained in the destination metadata. This action is invoked during forgotten knowledge recovery and corresponds to item deletes where the source replica has cleaned up the tombstone. | |
| DeleteAndStoreTombstone | The item is deleted from the destination item store. A tombstone is saved in the destination metadata. This action corresponds to an item that has been deleted from the source replica. | |
| UpdateVersionAndData | Item data is applied to the destination item store. Existing data is overwritten. The version provided overwrites the existing version in the destination metadata. This action corresponds to an item creation, item update, or change unit update in the source replica. It also occurs when the item from the source provider is selected as the winner of a conflict. | |
| UpdateVersionAndMergeData | Item data applied to the destination item store. Existing item data is merged with the updated item data by using some provider-specific method. The version overwrites the existing version in the destination metadata. This action occurs when the conflict resolution action is Merge. | |
| UpdateVersionOnly | Item data is not changed in the destination item store. The version is overwritten in the destination metadata. It also occurs when the item from the destination provider is selected as the winner of a conflict. |
Remarks
When the provider is not using a transaction for the whole change batch, the provider must retrieve updated knowledge from the SaveChangeContext object and save it at the same time it applies the change.