DataServiceContext.BeginSaveChanges-Methode (SaveChangesOptions, AsyncCallback, Object)
Übergibt die anstehenden Änderungen asynchron an den von DataServiceContext gesammelten Datendienst seit der letzten Speicherung von Änderungen.
Namespace: System.Data.Services.Client
Assembly: Microsoft.Data.Services.Client (in Microsoft.Data.Services.Client.dll)
Syntax
'Declaration
Public Function BeginSaveChanges ( _
options As SaveChangesOptions, _
callback As AsyncCallback, _
state As Object _
) As IAsyncResult
'Usage
Dim instance As DataServiceContext
Dim options As SaveChangesOptions
Dim callback As AsyncCallback
Dim state As Object
Dim returnValue As IAsyncResult
returnValue = instance.BeginSaveChanges(options, _
callback, state)
public IAsyncResult BeginSaveChanges(
SaveChangesOptions options,
AsyncCallback callback,
Object state
)
public:
IAsyncResult^ BeginSaveChanges(
SaveChangesOptions options,
AsyncCallback^ callback,
Object^ state
)
member BeginSaveChanges :
options:SaveChangesOptions *
callback:AsyncCallback *
state:Object -> IAsyncResult
public function BeginSaveChanges(
options : SaveChangesOptions,
callback : AsyncCallback,
state : Object
) : IAsyncResult
Parameter
- options
Typ: System.Data.Services.Client.SaveChangesOptions
Die Optionen für die der Client den ausstehenden Satz von Änderungen speichern kann.
- callback
Typ: System.AsyncCallback
Der beim Abschluss der Vorgangs aufzurufende Delegat.
- state
Typ: System.Object
Das benutzerdefinierte Statusobjekt, das zur Übergabe von Kontextdaten an die Rückrufmethode zu verwendet wird.
Rückgabewert
Typ: System.IAsyncResult
Ein IAsyncResult zur Darstellung des Status eines asynchronen Vorgangs.
Hinweise
Dem DataServiceContext werden Änderungen hinzugefügt, indem AttachTo, AttachLink, der AddObject, AddLink, DeleteObject, DeleteLink, Detach oder DetachLink aufgerufen wird.
Wenn Batch festgelegt wird, sind alle ausstehenden Änderungen in einem Batch in einem einzelnen Änderungssatz 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 einem Änderungssatz ein Fehler auf, werden die nachfolgenden Vorgänge nicht versucht. der Datendienst verarbeitet weiterhin jedoch den nächstern Änderungssatz 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.