DataServiceContext.BeginSaveChanges Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ü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 -> IAsyncResultPublic Function BeginSaveChanges (options As SaveChangesOptions, callback As AsyncCallback, state As Object) As IAsyncResultParameter
- 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 -> IAsyncResultPublic Function BeginSaveChanges (callback As AsyncCallback, state As Object) As IAsyncResultParameter
- 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.
