DataServiceContext.BeginSaveChanges 方法

定義

命名空間:

System.Data.Services.Client

組件:

System.Data.Services.Client.dll

將自從上一次儲存變更後 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

IAsyncResult，表示非同步作業的狀態。

備註

變更會以呼叫 DataServiceContext、AddObject、AddLink、AttachTo、AttachLink、DeleteObject、DeleteLink 或 Detach 的方式加入至 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

IAsyncResult，表示非同步作業的狀態。

備註

變更會以呼叫 DataServiceContext、AddObject、AddLink、AttachTo、AttachLink、DeleteObject、DeleteLink 或 Detach 的方式加入至 DetachLink。

變更會以如同 SaveChanges 方法的方式傳送至資料服務：每一個 HTTP 要求進行一個變更作業。

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