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, представляющий состояние асинхронной операции.

Комментарии

Изменения добавляются в 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, представляющий состояние асинхронной операции.

Комментарии

Изменения добавляются в DataServiceContext путем вызова AddObject, AddLink, AttachTo, AttachLink, DeleteObject, DeleteLink, Detach или DetachLink.

Изменения передаются в службу данных, как с помощью метода SaveChanges, — по одной операции изменения на HTTP-запрос.

Если во время обработки операции произошла ошибка, дополнительные операции службой данных не обрабатываются. Вместо этого формируется ответ, сообщающий клиенту, какие операции выполнены, их результаты и какие операции не рассматривались из-за ошибки.

Применяется к