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)

Syntax

'Declaration
Public Sub New ( _
    idFormats As SyncIdFormatGroup, _
    replicaId As SyncId, _
    itemId As SyncId, _
    winnerId As SyncId, _
    creationVersion As SyncVersion, _
    changeVersion As SyncVersion _
)
'Usage
Dim idFormats As SyncIdFormatGroup
Dim replicaId As SyncId
Dim itemId As SyncId
Dim winnerId As SyncId
Dim creationVersion As SyncVersion
Dim changeVersion As SyncVersion

Dim instance As New ItemChange(idFormats, _
    replicaId, itemId, winnerId, creationVersion, _
    changeVersion)

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

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

new : 
        idFormats:SyncIdFormatGroup * 
        replicaId:SyncId * 
        itemId:SyncId * 
        winnerId:SyncId * 
        creationVersion:SyncVersion * 
        changeVersion:SyncVersion -> ItemChange

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

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.

Exceptions

Exception	Condition
ArgumentNullException	idFormats, changeVersion, or winnerId is a null reference (Nothing in Visual Basic).
SyncIdFormatMismatchException	replicaId or itemId or winnerId is not of the format specified by idFormats.

Remarks

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.

See Also

Reference

ItemChange Class

ItemChange Overload

Microsoft.Synchronization Namespace