ExportXML()

Syntax

Ergebnis = ExportXML(#XML, *Adresse, Größe [, Flags])
Beschreibung
Schreibt den XML-Baum als Markup in den angegebenen Speicherpuffer.

Parameter

#XML Die zu exportierende XML-Struktur (Baum).
*Adresse Ein beschreibbarer Speicherbereich.
Größe Größe (in Bytes) des Speicherbereichs.
Flags (optional) Dies kann eine Kombination (mit dem '|' Operator) der folgenden Werte sein:
  #PB_XML_StringFormat : Schließt einen Byte-Order-Mark ein. Siehe WriteStringFormat() für weitere Informationen.
  #PB_XML_NoDeclaration: Schließt die XML-Deklaration nicht mit ein.
Hinweis: Entsprechend der XML-Spezifikation kann die XML-Deklaration nur weggelassen werden, wenn das Dokument in UTF-8 oder UTF-16 kodiert wird, oder wenn die Kodierungs-Information extern - z.B. durch ein Transfer-Protokoll - bereitgestellt wird. Aber auch dann ist es ratsam, die Deklaration im Dokument zu belassen.

Rückgabewert

Gibt einen Wert ungleich Null zurück, wenn die angegebene Länge groß genug war, um das gesamte Markup des Baums zu enthalten. ExportXMLSize() kann verwendet werden, um die benötigte Größe für diesen Puffer zu ermitteln.

Anmerkungen

Das erstellte XML-"Markup" (Formatierung) wird nicht neu formatiert. Es wird so zurückgeschrieben, wie es anfänglich geparst/erstellt wurde. Die Anzahl der zwischen den Tags geschriebenen Zeilenumbrüche/Leerzeichen wird im 'Text' jedes XML-Knotens gespeichert (siehe GetXMLNodeText() für weitere Informationen).

Um das XML-Markup vor dem Speichern neu zu formatieren, kann der 'Text' jedes XML-Knotens verändert werden oder FormatXML() kann benutzt werden, um einige gebräuchliche Neuformatierungs-Optionen auf den Baum anzuwenden.

Siehe auch

ExportXMLSize(), FormatXML(), ComposeXML(), SaveXML()

Unterstützte OS

Alle

<- ExamineXMLAttributes() - XML Inhaltsverzeichnis - ExportXMLSize() ->