Share via


SaveChangesOptions Enumeration

Indicates change options when SaveChanges is called.

This enumeration has a FlagsAttribute attribute that allows a bitwise combination of its member values.

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

Syntax

'Declaration
<FlagsAttribute> _
Public Enumeration SaveChangesOptions
'Usage
Dim instance As SaveChangesOptions
[FlagsAttribute]
public enum SaveChangesOptions
[FlagsAttribute]
public enum class SaveChangesOptions
[<FlagsAttribute>]
type SaveChangesOptions
public enum SaveChangesOptions

Members

Member name Description
Batch All pending changes are saved in a single batch request.
ContinueOnError Pending changes are saved by using multiple requests to the server, and the operation continues after an error occurs.
None Pending changes are saved by using multiple requests to the server, but the operation stops on the first failure (default).
PatchOnUpdate The PatchOnUpdate option.
ReplaceOnUpdate Pending updates are made by replacing all values of the entity in the data source with values from the updated entity.

Remarks

When the ContinueOnError option is set, subsequent operations are still tried even after an error occurs.

When batching is not used, the BatchHeaders property on the DataServiceResponse instance returns an empty collection and the BatchStatusCode property is zero.

You cannot set both Batch and ContinueOnError at the same time.

By default, the WCF Data Services client issues a MERGE request to send only the updated properties to the data service. When you set the ReplaceOnUpdate option, a PUT request is instead sent that replaces the entire entity in the data service. When you set the PatchOnUpdate option, a PATCH request is sent to update only the updated properties. You cannot set both ReplaceOnUpdate and PatchOnUpdate.

The PatchOnUpdate option is only supported in version 3 of the Open Data Protocol (OData) and later versions.

See Also

Reference

System.Data.Services.Client Namespace

Other Resources

Updating the Data Service (WCF Data Services)