Datasnap.Provider.TCustomResolver.ApplyUpdates
Delphi
function ApplyUpdates(const Delta: OleVariant; MaxErrors: Integer; out ErrorCount: Integer): OleVariant; virtual;
C++
virtual System::OleVariant __fastcall ApplyUpdates(const System::OleVariant &Delta, int MaxErrors, /* out */ int &ErrorCount);
Propriétés
Type | Visibilité | Source | Unité | Parent |
---|---|---|---|---|
function | public | Datasnap.Provider.pas Datasnap.Provider.hpp |
Datasnap.Provider | TCustomResolver |
Description
Applique les mises à jour reçues d'un fournisseur.
Providers appellent ApplyUpdates pour appliquer les mises à jour reçues d'un ensemble de données client ou d'un agent XML.
ApplyUpdates génère un événement OnUpdateData sur le fournisseur associé, puis applique les mises à jour passées comme paramètre Delta et renvoie une OleVariant contenant toutes les mises à jour qui n'ont pas pu être appliquées.
Le paramètre Delta spécifie un paquet delta qui contient des insertions, des suppressions et des modifications à appliquer. MaxErrors indique le nombre maximum d'erreurs permis avant d'avorter l'opération de mise à jour. ErrorCount renvoie le nombre réel d'erreurs rencontrées pendant l'opération de mise à jour. Si ErrorCount est supérieur à MaxErrors, (ou si un événement OnUpdateError renvoie rrAbort), toutes les mises à jour appliquées avec succès sont annulées et le processus de mise à jour est avorté.
Si le fournisseur associé a un gestionnaire d'événement OnUpdateError, il est appelé automatiquement chaque fois qu'un enregistrement dans Delta ne peut pas être mis à jour. Dans le gestionnaire OnUpdateError, les applications peuvent corriger des conditions d'erreur et tenter d'appliquer à nouveau une mise à jour avant de renvoyer des enregistrements non mis à jour à l'ensemble de données client ou à l'agent XML.