Méthode DataServiceContext.BeginSaveChanges (SaveChangesOptions, AsyncCallback, Object)
Soumet de façon asynchrone au service de données les modifications en attente collectées par le DataServiceContext depuis le dernier enregistrement de ces modifications.
Espace de noms : System.Data.Services.Client
Assembly : Microsoft.Data.Services.Client (en Microsoft.Data.Services.Client.dll)
Syntaxe
'Déclaration
Public Function BeginSaveChanges ( _
options As SaveChangesOptions, _
callback As AsyncCallback, _
state As Object _
) As IAsyncResult
'Utilisation
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
Paramètres
- options
Type : System.Data.Services.Client.SaveChangesOptions
Options relatives au mode d'enregistrement par le client de l'ensemble de modifications en attente.
- callback
Type : System.AsyncCallback
Délégué à appeler lorsque l'opération est terminée.
- state
Type : System.Object
Objet d'état défini par l'utilisateur qui est utilisé pour passer des données de contexte à la méthode de rappel.
Valeur de retour
Type : System.IAsyncResult
IAsyncResult qui représente l'état de l'opération asynchrone.
Notes
Les modifications sont ajoutées au DataServiceContext en appelant AddObject, AddLink, AttachTo, AttachLink, DeleteObject, DeleteLink, Detach ou DetachLink.
Si Batch est défini, toutes les modifications en attente sont incluses dans un même ensemble de modifications présent dans un lot et soumises au service de données dans une même requête HTTP. Cela nécessite que le service cible prenne en charge le traitement par lots.
Si Batch n'est pas défini :
Les modifications sont envoyées au service de données comme dans la méthode SaveChanges() : une opération à une requête HTTP.
StatusCode est toujours 200.
La propriété Headers retourne une collection vide.
Si ContinueOnError est défini :
Si une erreur se produit lors du traitement d'une opération dans un ensemble de modifications, les opérations suivantes contenues dans l'ensemble de modifications ne sont pas tentées ; toutefois, le service de données continue à traiter l'ensemble de modifications suivant présent dans le lot.
Cette option ne peut pas être définie lorsque Batch est défini car, lorsque le traitement par lots est activé, toutes les opérations sont placées dans un même ensemble de modifications.
Si ContinueOnError n'est pas défini :
- Si une erreur se produit pendant le traitement d'une opération, aucune opération supplémentaire n'est traitée par le service de données.
Une réponse est générée et indique au client les opérations exécutées, leurs résultats et les opérations qui n'ont pas été tentées à cause de l'erreur.