Share via


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 要求進行一個變更作業。

如果在處理作業時發生錯誤,資料服務不會處理任何其他作業, 而是產生回應,告知用戶端哪些作業已執行、結果,以及哪些作業由於錯誤而未嘗試。

適用於