ChangeBatchBase::AddChanges Method

Adds a specified set of item changes to the group that currently open

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

public:
void AddChanges(
	IEnumerable<ItemChange^>^ changes
)

Parameters

changes
Type: System.Collections.Generic::IEnumerable<ItemChange>
A set of item changes to add to the group that is currently open.

ExceptionCondition
ChangeBatchIsReadOnlyException

The change batch has already been sent to a change applier or synchronization session. Changes cannot be added to the batch after it has been sent.

ArgumentNullException

changes is a nullptr.

ObjectDisposedException

This ChangeBatchBase has been disposed.

InvalidOperationException
  • One of the changes in changes contains a CreationVersion that is a nullptr

  • One of the changes in changes contains a ChangeVersion that is a nullptr and its ChangeUnitChanges is empty.

—or—

  • There is no current change group.

Before item changes can be added to a ChangeBatchBase object, a group must be opened by calling BeginOrderedGroup or the BeginUnorderedGroup method of the ChangeBatch object. Otherwise, this method throws InvalidOperationException.

Show: