Freigeben über


DataServiceContext.BeginSaveChanges Methode

Definition

Übergibt die anstehenden Änderungen an den von DataServiceContext gesammelten Datendienst seit der letzten Speicherung von Änderungen.

Überlädt

BeginSaveChanges(SaveChangesOptions, AsyncCallback, Object)

Übergibt die anstehenden Änderungen asynchron an den von DataServiceContext gesammelten Datendienst seit der letzten Speicherung von Änderungen.

BeginSaveChanges(AsyncCallback, Object)

Übergibt die anstehenden Änderungen asynchron an den von DataServiceContext gesammelten Datendienst seit der letzten Speicherung von Änderungen.

BeginSaveChanges(SaveChangesOptions, AsyncCallback, Object)

Übergibt die anstehenden Änderungen asynchron an den von DataServiceContext gesammelten Datendienst seit der letzten Speicherung von Änderungen.

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

Parameter

options
SaveChangesOptions

Die Optionen für die der Client den ausstehenden Satz von Änderungen speichern kann.

callback
AsyncCallback

Der beim Abschluss der Vorgangs aufzurufende Delegat.

state
Object

Das benutzerdefinierte Statusobjekt, das zur Übergabe von Kontextdaten an die Rückrufmethode zu verwendet wird.

Gibt zurück

Ein IAsyncResult zur Darstellung des Status eines asynchronen Vorgangs.

Hinweise

Dem DataServiceContext werden Änderungen hinzugefügt, indem AddObject, AddLink, der AttachTo, AttachLink, DeleteObject, DeleteLink, Detach oder DetachLink aufgerufen wird.

Wenn Batch festgelegt wird, sind alle ausstehenden Änderungen in einem Batch in einem einzelnen Changeset enthalten und werden an den Datendienst in einer einzelnen HTTP-Anforderung gesendet. Dies erfordert, dass der Zieldienst die Batch-Verarbeitung unterstützt.

Ist Batch nicht festgelegt:

  • Änderungen werden z. B. in der SaveChanges()-Methode an den Datendienst gesendet: ein Vorgang zu einer HTTP-Anforderung.

  • StatusCode ist stets 200.

  • Die Headers-Eigenschaft gibt eine leere Auflistung zurück.

Wenn ContinueOnError festgelegt wird:

  • Tritt beim Verarbeiten in einem Changeset ein Fehler auf, werden die nachfolgenden Vorgänge nicht versucht. Der Datendienst verarbeitet weiterhin jedoch das nächste Changeset im Batch.

  • Diese Option kann nicht festgelegt werden, wenn Batch definiert ist, da bei aktivierter Batch-Verarbeitung alle Vorgänge in einem einzelnen Änderungssatz positioniert werden.

Ist ContinueOnError nicht festgelegt:

  • Tritt Verarbeiten eines Vorgangs ein Fehler auf, werden keine zusätzlichen Vorgänge vom Datendienst verarbeitet.

Es wird eine Antwort erstellt, die dem Client mitteilt, welche Vorgänge durchgeführt wurden, welche Ergebnisse erzielt wurden und welche Vorgänge aufgrund eines Fehlers nicht versucht wurden.

Gilt für:

BeginSaveChanges(AsyncCallback, Object)

Übergibt die anstehenden Änderungen asynchron an den von DataServiceContext gesammelten Datendienst seit der letzten Speicherung von Änderungen.

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

Parameter

callback
AsyncCallback

Der beim Abschluss der Vorgangs aufzurufende Delegat.

state
Object

Das benutzerdefinierte Statusobjekt, das zur Übergabe von Kontextdaten an die Rückrufmethode zu verwendet wird.

Gibt zurück

Ein IAsyncResult zur Darstellung des Status eines asynchronen Vorgangs.

Hinweise

Dem DataServiceContext werden Änderungen hinzugefügt, indem AddObject, AddLink, der AttachTo, AttachLink, DeleteObject, DeleteLink, Detach oder DetachLink aufgerufen wird.

Änderungen werden wie mit der Methode SaveChanges an den Datendienst gesendet – ein Vorgang je HTTP-Anforderung.

Tritt Verarbeiten eines Vorgangs ein Fehler auf, werden keine zusätzlichen Vorgänge vom Datendienst verarbeitet. Stattdessen wird eine Antwort erstellt, die dem Client mitteilt, welche Vorgänge durchgeführt wurden, welche Ergebnisse erzielt wurden und welche Vorgänge aufgrund eines Fehlers nicht versucht wurden.

Gilt für: