Xml.XmlTransform.TXMLTransform.TransformXML

De RAD Studio API Documentation
Aller à : navigation, rechercher

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());

Propriétés

Type Visibilité  Source Unité  Parent
function public
Xml.XmlTransform.pas
Xml.XmlTransform.hpp
Xml.XmlTransform TXMLTransform

Description

Convertit un document XML à l'aide des spécifications d'un fichier de transformation.

Appelez TransformXML pour convertir un document XML lorsque le XML source est une chaîne en mémoire.

SourceXml est une chaîne de XML à transformer. Elle peut représenter tout type de document XML, y compris un paquet de données XML. Elle doit, toutefois, respecter le schéma attendu par le document de transformation utilisé pour effectuer la transformation. Si la transformation convertit un type spécifique de document XML en un paquet de données, SourceXml doit respecter le schéma attendu. Si la transformation convertit un paquet de données en un document XML, SourceXml doit être un paquet de données XML possédant les métadonnées attendues.

ATransformationFile est le fichier de transformation à utiliser pour effectuer la traduction. Un fichier de transformation est un type spécial de fichier XML portant l'extension .xtr. Chaque fichier de transformation est spécifique à un format de paquet de données et à un schéma XML et représente une transformation unidirectionnelle. Utilisez l'utilitaire xmlmapper pour créer des fichiers de transformation.

Si le paramètre ATransformationFile est ignoré, TransformXML utilise le fichier spécifié par la propriété TransformationFile ou le document spécifié par la propriété TransformationDocument.

TransformXML renvoie le résultat de la conversion sous la forme d'une chaîne de XML.

Voir aussi