DataServiceContext.BeginSaveChanges Méthode

Définition

Soumet au service de données les modifications en attente collectées par le DataServiceContext depuis le dernier enregistrement de ces modifications.

Surcharges

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.

BeginSaveChanges(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.

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.

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

Paramètres

options
SaveChangesOptions

Options relatives au mode d'enregistrement par le client de l'ensemble de modifications en attente.

callback
AsyncCallback

Délégué à appeler lorsque l'opération est terminée.

state
Object

Objet d'état défini par l'utilisateur qui est utilisé pour passer des données de contexte à la méthode de rappel.

Retours

IAsyncResult qui représente l'état de l'opération asynchrone.

Remarques

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.

S’applique à

BeginSaveChanges(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.

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

Paramètres

callback
AsyncCallback

Délégué à appeler lorsque l'opération est terminée.

state
Object

Objet d'état défini par l'utilisateur qui est utilisé pour passer des données de contexte à la méthode de rappel.

Retours

IAsyncResult qui représente l'état de l'opération asynchrone.

Remarques

Les modifications sont ajoutées au DataServiceContext en appelant AddObject, AddLink, AttachTo, AttachLink, DeleteObject, DeleteLink, Detach ou DetachLink.

Les modifications sont envoyées au service de données, comme avec la méthode SaveChanges, une opération de modification par requête HTTP.

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. À la place, une réponse est générée et indique au client les opérations exécutées, les résultats et les opérations qui n'ont pas été tentées à cause d'une erreur.

S’applique à