MergeOption Enumeration

 

Updated: November 29, 2016

Applies To: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Describes the synchronization option for sending or receiving entity data to or from a data service using the OrganizationServiceContext.

Namespace:   Microsoft.Xrm.Sdk.Client
Assembly:  Microsoft.Xrm.Sdk (in Microsoft.Xrm.Sdk.dll)

public enum MergeOption

Member nameDescription
AppendOnly

New Microsoft Dynamics 365 entities are appended. Existing entities or their original values are not be modified. No client-side changes are lost in this merge. This is the default behavior. Value = 0.

NoTracking

Microsoft Dynamics 365 entities are always loaded from persisted storage. Any attribute changes made to entities in the OrganizationServiceContext are overwritten by the data source values. Value = 3.

OverwriteChanges

All current values on the client are overwritten with current values from the Web service regardless of whether they have been changed on the client. Value = 1.

PreserveChanges

Current values that have been changed on the client are not modified, but any unchanged values are updated with current values from the Web service. No client-side changes are lost in this merge. Value = 2.

Return to top

Microsoft Dynamics 365

© 2016 Microsoft. All rights reserved. Copyright

Community Additions

Show: