SaveXML

SaveXML()

Syntax

Ergebnis = SaveXML(#XML, DateiName$ [, Flags])

Beschreibung

Speichert den #XML Baum in der angegebenen Datei.

Parameter

#XML Die zu speichernde XML-Struktur (Baum).

DateiName$ Der Dateiname, unter dem die XML-Struktur gespeichert werden soll.
Flags (optional)
Dies kann eine Kombination (mittels 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 Datei erfolgreich gespeichert wurde, andernfalls Null.

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

LoadXML(), CreateXML(), FormatXML(), ExportXML(), ComposeXML()

Unterstützte OS

Alle

<- RootXMLNode() - XML Inhaltsverzeichnis - SetXMLAttribute() ->

#XML	Die zu speichernde XML-Struktur (Baum).
DateiName$	Der Dateiname, unter dem die XML-Struktur gespeichert werden soll.
Flags (optional)	Dies kann eine Kombination (mittels 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.