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