MergeOption Enumeration

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)

Syntax

public enum MergeOption

Public Enumeration MergeOption

	Member name	Description
	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.