Xml.XmlTransform.TXMLTransform.Data
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.