NotifyingChangeApplier.ApplyChanges Method (ConflictResolutionPolicy, ChangeBatch, IChangeDataRetriever, IEnumerable<ItemChange>, SyncKnowledge, ForgottenKnowledge, INotifyingChangeApplierTarget, SyncSessionContext, SyncCallbacks)

Performs conflict detection, conflict handling, and change application for a batch of changes.

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

Syntax

'Declaration
Public Sub ApplyChanges ( _
    resolutionPolicy As ConflictResolutionPolicy, _
    sourceChanges As ChangeBatch, _
    changeDataRetriever As IChangeDataRetriever, _
    destinationVersions As IEnumerable(Of ItemChange), _
    destinationKnowledge As SyncKnowledge, _
    destinationForgottenKnowledge As ForgottenKnowledge, _
    changeApplierTarget As INotifyingChangeApplierTarget, _
    syncSessionState As SyncSessionContext, _
    syncCallback As SyncCallbacks _
)
'Usage
Dim instance As NotifyingChangeApplier
Dim resolutionPolicy As ConflictResolutionPolicy
Dim sourceChanges As ChangeBatch
Dim changeDataRetriever As IChangeDataRetriever
Dim destinationVersions As IEnumerable(Of ItemChange)
Dim destinationKnowledge As SyncKnowledge
Dim destinationForgottenKnowledge As ForgottenKnowledge
Dim changeApplierTarget As INotifyingChangeApplierTarget
Dim syncSessionState As SyncSessionContext
Dim syncCallback As SyncCallbacks

instance.ApplyChanges(resolutionPolicy, _
    sourceChanges, changeDataRetriever, _
    destinationVersions, destinationKnowledge, _
    destinationForgottenKnowledge, _
    changeApplierTarget, syncSessionState, _
    syncCallback)

public void ApplyChanges(
    ConflictResolutionPolicy resolutionPolicy,
    ChangeBatch sourceChanges,
    IChangeDataRetriever changeDataRetriever,
    IEnumerable<ItemChange> destinationVersions,
    SyncKnowledge destinationKnowledge,
    ForgottenKnowledge destinationForgottenKnowledge,
    INotifyingChangeApplierTarget changeApplierTarget,
    SyncSessionContext syncSessionState,
    SyncCallbacks syncCallback
)

public:
void ApplyChanges(
    ConflictResolutionPolicy resolutionPolicy, 
    ChangeBatch^ sourceChanges, 
    IChangeDataRetriever^ changeDataRetriever, 
    IEnumerable<ItemChange^>^ destinationVersions, 
    SyncKnowledge^ destinationKnowledge, 
    ForgottenKnowledge^ destinationForgottenKnowledge, 
    INotifyingChangeApplierTarget^ changeApplierTarget, 
    SyncSessionContext^ syncSessionState, 
    SyncCallbacks^ syncCallback
)

member ApplyChanges : 
        resolutionPolicy:ConflictResolutionPolicy * 
        sourceChanges:ChangeBatch * 
        changeDataRetriever:IChangeDataRetriever * 
        destinationVersions:IEnumerable<ItemChange> * 
        destinationKnowledge:SyncKnowledge * 
        destinationForgottenKnowledge:ForgottenKnowledge * 
        changeApplierTarget:INotifyingChangeApplierTarget * 
        syncSessionState:SyncSessionContext * 
        syncCallback:SyncCallbacks -> unit 

public function ApplyChanges(
    resolutionPolicy : ConflictResolutionPolicy, 
    sourceChanges : ChangeBatch, 
    changeDataRetriever : IChangeDataRetriever, 
    destinationVersions : IEnumerable<ItemChange>, 
    destinationKnowledge : SyncKnowledge, 
    destinationForgottenKnowledge : ForgottenKnowledge, 
    changeApplierTarget : INotifyingChangeApplierTarget, 
    syncSessionState : SyncSessionContext, 
    syncCallback : SyncCallbacks
)

Parameters

• resolutionPolicy
  Type: Microsoft.Synchronization.ConflictResolutionPolicy
  The policy to use for resolving conflicts.

• sourceChanges
  Type: Microsoft.Synchronization.ChangeBatch
  The batch of changes from the source provider.

• changeDataRetriever
  Type: Microsoft.Synchronization.IChangeDataRetriever
  An object that can be used to retrieve item data from the source replica.

• destinationVersions
  Type: System.Collections.Generic.IEnumerable<ItemChange>
  A batch of changes that contains the versions of items that are stored in the destination replica. These items correspond to the items in sourceChanges.

• destinationKnowledge
  Type: Microsoft.Synchronization.SyncKnowledge
  The knowledge of the destination replica.

• destinationForgottenKnowledge
  Type: Microsoft.Synchronization.ForgottenKnowledge
  The forgotten knowledge of the destination replica.

• changeApplierTarget
  Type: Microsoft.Synchronization.INotifyingChangeApplierTarget
  The object that will be called to save changes and conflicts.

• syncSessionState
  Type: Microsoft.Synchronization.SyncSessionContext
  State information about the current session.

• syncCallback
  Type: Microsoft.Synchronization.SyncCallbacks
  Callbacks that will receive notifications about change application events.

Exceptions

Exception	Condition
ArgumentNullException	sourceChanges, changeDataRetriever, destinationKnowledge, changeApplierTarget, or syncCallback is a null reference (Nothing in Visual Basic).
ArgumentOutOfRangeException	resolutionPolicy is not member of the ConflictResolutionPolicy enumeration.
SyncIdFormatMismatchException	sourceChanges has some forgotten knowledge which is in a different format than that of destinationKnowledge —or— destinationForgottenKnowledge was given and has a different format than that of destinationKnowledge

Remarks

This method detects conflicts that occur between the changes sent in sourceChanges and the corresponding items in the destination replica. It resolves any conflicts according to the policy specified by resolutionPolicy. If it is necessary, this method then calls methods on changeApplierTarget to save changes to the destination replica and to save unresolved conflicts.

See Also

Reference

NotifyingChangeApplier Class

ApplyChanges Overload

Microsoft.Synchronization Namespace