Datasnap.Xmlxform.TXMLTransformClient.ApplyUpdates
Delphi
function ApplyUpdates(const UpdateXML, UpdateTransformFile: string; MaxErrors: Integer): Integer; virtual;
C++
virtual int __fastcall ApplyUpdates(const System::UnicodeString UpdateXML, const System::UnicodeString UpdateTransformFile, int MaxErrors);
Eigenschaften
| Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
|---|---|---|---|---|
| function | public | Datasnap.Xmlxform.pas Datasnap.Xmlxform.hpp |
Datasnap.Xmlxform | TXMLTransformClient |
Beschreibung
Konvertiert ein XML-Dokument mit Aktualisierungen in ein Delta-Paket und sendet dieses an den Provider.
Mit ApplyUpdates können Sie ein XML-Dokument mit Aktualisierungen in ein Delta-Paket konvertieren und zum Eintragen an den Provider senden. Die Methode ApplyUpdates kann erst aufgerufen werden, wenn Sie die Transformationsdatei für das TXMLTransform-Objekt (TransformApplyUpdates) mit dessen Eigenschaft TransformationFile oder TransformationDocument angegeben haben.
UpdateXML ist das XML-Dokument, das in ein Delta-Paket konvertiert werden soll. Normalerweise wird dazu eine XML-Datei verwendet.
UpdateTransformFile enthält den Namen der Transformationsdatei für die Konvertierung. Eine Transformationsdatei ist eine spezielle XML-Datei mit der Namenserweiterung XTR. Sie entspricht einem bestimmten XML-Schema, Datenpaketformat und Aktualisierungstyp (Einfügen oder Löschen). Transformationsdateien können mit dem Dienstprogramm xmlmapper erstellt werden.
Anmerkung: Wenn in der Transformationsdatei benutzerdefinierte Konvertierungen definiert sind, generiert die Methode ApplyUpdates ein OnTranslate-Ereignis im TXMLTransform-Objekt, sobald benutzerdefinierte Knoten in UpdateXML in die entsprechenden Feldwerte umgewandelt werden müssen.
MaxErrors gibt die maximale Anzahl Fehler an, die der Provider tolerieren soll, bevor die Aktualisierungsoperation frühzeitig abgebrochen wird. Wenn Sie die Eigenschaft auf –1 setzen, sind beliebig viele Fehler erlaubt.
ApplyUpdates gibt die Anzahl der ermittelten Fehler zurück.