DataServiceContext.BeginSaveChanges 方法

定义

向数据服务提交自上次保存更改以来,由 DataServiceContext 收集的挂起更改。

重载

BeginSaveChanges(SaveChangesOptions, AsyncCallback, Object)

以异步方式向数据服务提交自上次保存更改以来,由 DataServiceContext 收集的挂起更改。

BeginSaveChanges(AsyncCallback, Object)

以异步方式向数据服务提交自上次保存更改以来,由 DataServiceContext 收集的挂起更改。

BeginSaveChanges(SaveChangesOptions, AsyncCallback, Object)

以异步方式向数据服务提交自上次保存更改以来,由 DataServiceContext 收集的挂起更改。

public:
 IAsyncResult ^ BeginSaveChanges(System::Data::Services::Client::SaveChangesOptions options, AsyncCallback ^ callback, System::Object ^ state);
public IAsyncResult BeginSaveChanges (System.Data.Services.Client.SaveChangesOptions options, AsyncCallback callback, object state);
member this.BeginSaveChanges : System.Data.Services.Client.SaveChangesOptions * AsyncCallback * obj -> IAsyncResult
Public Function BeginSaveChanges (options As SaveChangesOptions, callback As AsyncCallback, state As Object) As IAsyncResult

参数

options
SaveChangesOptions

客户端保存挂起的更改集的方式选项。

callback
AsyncCallback

完成操作时要调用的委托。

state
Object

用户定义的状态对象,用于将上下文数据传递给回调方法。

返回

表示异步操作状态的 IAsyncResult

注解

通过调用 DataServiceContextAddObjectAddLinkAttachToAttachLinkDeleteObjectDeleteLinkDetach,将更改添加到 DetachLink

如果已设置 Batch 属性,则所有挂起的更改都将包括在批处理的单个变更集中,并将在单个 HTTP 请求中提交到数据服务。 这要求目标服务支持批处理。

未设置 Batch 时:

  • 采用 SaveChanges() 之类的方法将更改发送到数据服务:一个 HTTP 请求一个操作。

  • StatusCode 始终为 200。

  • Headers 属性会返回空集合。

已设置 ContinueOnError 时:

  • 如果在处理变更集中的某个操作时出错,则不会尝试处理该变更集中的后续操作;然而,数据服务将继续处理批处理中的下一个变更集。

  • 已设置 Batch 的情况下无法设置此选项,因为启用批处理时,所有操作都将放置在单个更改集中。

未设置 ContinueOnError 时:

  • 如果在处理操作时出错,则数据服务将不处理任何附加操作,

而是改为生成响应,告知客户端已执行的操作、操作结果以及因错误而未尝试的操作。

适用于

BeginSaveChanges(AsyncCallback, Object)

以异步方式向数据服务提交自上次保存更改以来,由 DataServiceContext 收集的挂起更改。

public:
 IAsyncResult ^ BeginSaveChanges(AsyncCallback ^ callback, System::Object ^ state);
public IAsyncResult BeginSaveChanges (AsyncCallback callback, object state);
member this.BeginSaveChanges : AsyncCallback * obj -> IAsyncResult
Public Function BeginSaveChanges (callback As AsyncCallback, state As Object) As IAsyncResult

参数

callback
AsyncCallback

完成操作时要调用的委托。

state
Object

用户定义的状态对象,用于将上下文数据传递给回调方法。

返回

表示异步操作状态的 IAsyncResult

注解

通过调用 DataServiceContextAddObjectAddLinkAttachToAttachLinkDeleteObjectDeleteLinkDetach,将更改添加到 DetachLink

SaveChanges 方法一样,将更改发送到数据服务(一个 HTTP 请求一个更改操作)。

如果在处理操作时出错,则数据服务将不处理任何附加操作, 而是改为生成响应,告知客户端已执行的操作、结果以及因错误而未尝试的操作。

适用于