Xml.XmlTransform.TXMLTransform.Data

Übergeordnet: TXMLTransform

Delphi

property Data: string read GetData ;

C++

__property System::UnicodeString Data = {read=GetData};

Eigenschaften

Typ	Sichtbarkeit	Quelle	Unit	Übergeordnet
property	public	Xml.XmlTransform.pas Xml.XmlTransform.hpp	Xml.XmlTransform	TXMLTransform

Beschreibung

Enthält den konvertierten XML-String.

Mit Data können Sie auf das Ergebnis der Konvertierung zugreifen. Wenn Sie die Eigenschaft lesen, konvertiert die TXMLTransform-Komponente das XML-Quelldokument oder Datenpaket und weist es Data zu. Da der XML-String nicht im Speicher bleibt, muss die Konvertierung bei jedem Lesezugriff durchgeführt werden.

Wenn die XML-Quelle ein Dokument ist und in der Transformationsdatei die entsprechenden Umwandlungsinformationen definiert sind, wird Data ein Datenpaket im XML-Format zugewiesen.

Wenn die XML-Quelle ein Datenpaket ist und in der Transformationsdatei die entsprechenden Umwandlungsinformationen definiert sind, wird Data der Inhalt des konvertierten XML-Dokuments zugewiesen.

Sie können das zu konvertierende Quelldokument oder Datenpaket auf drei Arten angeben:

Mit der Eigenschaft SourceXmlFile, wenn sich das Dokument in einer Datei befindet.
Mit der Eigenschaft SourceXml, wenn das Dokument als String mit XML-Text vorliegt.
Mit der Eigenschaft SourceXmlDocument, wenn auf das Dokument über eine DOM-Schnittstelle (IDOMDocument) zugegriffen werden kann.
Wenn SourceXmlFile einen ungültigen Dateinamen oder einen Leerstring und SourceXml keinen gültigen XML-String enthält, oder wenn SourceXmlFile und SourceXml einen Leerstring enthalten und SourceXmlDocument nicht zugewiesen ist, wird beim Zugriff auf Data eine TranslateException-Exception ausgelöst.
Das Transformationsdokument mit den Konvertierungsinformationen kann auf zwei Arten angegeben werden:
Mit der Eigenschaft TransformationFile, wenn die Informationen in einer Datei gespeichert sind.
Mit der Eigenschaft TransformationDocument, wenn auf die Informationen über eine DOM-Schnittstelle (IDOMDocument) zugegriffen werden kann.
Wenn TransformationFile einen ungültigen Dateinamen oder einen Leerstring enthält und TransformationDocument nicht zugewiesen ist, wird beim Lesen von Data eine TranslateException-Exception ausgelöst.
Sie können die Konvertierung effizienter durchführen, indem Sie der Eigenschaft EmptyDestinationDocument eine Vorlage mit dem gewünschten Dokumentformat zuweisen.
Wenn Sie auf Data zugreifen, generiert die TXMLTransform-Komponente für jeden benutzerdefinierten Knoten im Quelldokument ein OnTranslate-Ereignis. Die Konvertierung kann in der entsprechenden Ereignisbehandlungsroutine durchgeführt werden.

Tip: Wenn ein XML-Dokument in ein Datenpaket konvertiert wird, kann der Wert von Data der Eigenschaft XMLData einer Client-Datenmenge zugewiesen werden.