Xml.XmlTransform.TXMLTransform.TransformXML
Delphi
function TransformXML(const SourceXml: string; const ATransformationFile: string = ''): string;
C++
System::UnicodeString __fastcall TransformXML(const System::UnicodeString SourceXml, const System::UnicodeString ATransformationFile = System::UnicodeString());
Eigenschaften
| Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
|---|---|---|---|---|
| function | public | Xml.XmlTransform.pas Xml.XmlTransform.hpp |
Xml.XmlTransform | TXMLTransform |
Beschreibung
Konvertiert ein XML-Dokument entsprechend den Anweisungen in einer Transformationsdatei.
Mit TransformXML kann ein String mit einem XML-Dokument konvertiert werden.
SourceXml gibt den XML-Text an, der konvertiert werden soll. Es kann sich dabei um den Inhalt eines beliebigen XML-Dokuments oder -Datenpakets handeln. Der Text muss aber dem Schema der Transformationsdatei entsprechen. Ist in dieser Datei die Konvertierung eines bestimmten Typs von XML-Dokument in ein Datenpaket definiert, muss SourceXml mit dem erwarteten Schema übereinstimmen. Wird die Konvertierung eines Datenpakets in ein XML-Dokument definiert, übergeben Sie in SourceXml ein XML-Datenpaket mit den entsprechenden Metadaten.
ATransformationFile ist die Transformationsdatei mit den Konvertierungsanweisungen. Eine Transformationsdatei ist eine spezielle XML-Datei mit der Namenserweiterung XTR. Jede Datei wird für ein bestimmtes XML-Schema und -Datenpaketformat verwendet und ermöglicht die Konvertierung in eine Richtung. Transformationsdateien können mit dem Dienstprogramm xmlmapper erstellt werden.
Wird in ATransformationFile keine Datei übergeben, verwendet die Komponente den Wert der Eigenschaft TransformationFile oder TransformationDocument.
TransformXML gibt das konvertierte Dokument als String zurück.