Partager via


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

  • 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.

Voir aussi

Référence

DataServiceContext Classe

Surcharge BeginSaveChanges

Espace de noms System.Data.Services.Client