MergeOption Enumeration

Determines the synchronization option for sending or receiving entities to or from WCF Data Services. 

Namespace:  System.Data.Services.Client
Assembly:  Microsoft.Data.Services.Client (in Microsoft.Data.Services.Client.dll)

Syntax

'Declaration
Public Enumeration MergeOption
'Usage
Dim instance As MergeOption
public enum MergeOption
public enum class MergeOption
type MergeOption
public enum MergeOption

Members

Member name Description
AppendOnly Append new entities only. Existing entities or their original values will not be modified. No client-side changes are lost in this merge. This is the default behavior.
NoTracking Objects are always loaded from persisted storage. Any property changes made to objects in the object context are overwritten by the data source values.
OverwriteChanges All current values on the client are overwritten with current values from the data service regardless of whether they have been changed on the client.
PreserveChanges Current values that have been changed on the client are not modified, but any unchanged values are updated with current values from the data service. No client-side changes are lost in this merge.

Remarks

This value is used when materializing objects. Set this property to the appropriate materialization option before executing any queries or updates to the data service. The default value is MergeOption.AppendOnly.

See Also

Reference

System.Data.Services.Client Namespace

Other Resources

Object Materialization (WCF Data Services)

Query Projections (WCF Data Services)

Querying the Data Service (WCF Data Services)