Datasnap.Provider.TCustomResolver.ApplyUpdates

De RAD Studio API Documentation
Aller à : navigation, rechercher

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.

Voir aussi