Merge Basics

MergeVersion modifies an object version by combining its property values and collections with those of another version of the same object.

MergeVersion does not combine two versions into a third, newly created version. Rather, it merges the property values and collections of one version into another version. After the operation is complete, the modified version becomes a successor of the other version. MergeVersion modifies the version graph accordingly.

When you invoke MergeVersion, the object version you will use as predecessor of the merge must already be frozen. The object version to be modified — the successor of the merge — cannot be frozen.

Briefly, the merge operation has these results:

• The object's version graph is updated, to indicate that the merge operation occurred.
  
  
• The successor object can have different property values or collections.