ItemChange Constructor (SyncIdFormatGroup, SyncId, SyncId, SyncId, SyncVersion, SyncVersion)

Initializes a new instance of the ItemChange class that represents a merge tombstone, by using the specified ID format schema, replica ID, item ID, winning item ID, creation version, and change version.

Namespace:  Microsoft.Synchronization
Assembly:  Microsoft.Synchronization (in Microsoft.Synchronization.dll)

public:
ItemChange(
	SyncIdFormatGroup^ idFormats, 
	SyncId^ replicaId, 
	SyncId^ itemId, 
	SyncId^ winnerId, 
	SyncVersion^ creationVersion, 
	SyncVersion^ changeVersion
)

Parameters

idFormats
Type: Microsoft.Synchronization::SyncIdFormatGroup
The ID format schema of the provider.
replicaId
Type: Microsoft.Synchronization::SyncId
The ID of the replica that originated this change.
itemId
Type: Microsoft.Synchronization::SyncId
The ID of the item before the merge occurred. This is also called the losing ID.
winnerId
Type: Microsoft.Synchronization::SyncId
The ID of the item after the merge occurred. This is also called the winning ID.
creationVersion
Type: Microsoft.Synchronization::SyncVersion
The creation version of the item identified by itemId.
changeVersion
Type: Microsoft.Synchronization::SyncVersion
The version of the change.

ExceptionCondition
ArgumentNullException

idFormats, changeVersion, or winnerId is a nullptr.

SyncIdFormatMismatchException

replicaId or itemId or winnerId is not of the format specified by idFormats.

A merge tombstone is used to indicate that conflicting items with different item IDs have been merged into one item that is identified by the winning item ID. The merge tombstone indicates that the losing item ID refers to the same item as the winning item ID. For more information, see Detecting and Resolving Constraint Conflicts.

Show: