<xmlDocument variable>.BuildString (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help / WLanguage / WLanguage functions / Standard functions / XML file functions

XML functions and threads

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

<xmlDocument variable>.BuildString (Function)

In french: <Variable xmlDocument>.ConstruitChaîne

Retrieves and formats the content of an XML document.

The corresponding character string can be saved as an XML file by fSaveText. Reminder: The fSaveText function creates a text-only file in ANSI format. To create a Unicode text file, use <DiskFile variable>.Open / <DiskFile variable>.Write.

In the final XML document, the list of attributes is sorted in alphabetical order.

If the XML document to format contains the declaration of an internal DTD, the description of this DTD will not be transcribed in the final XML document.

Example

SourceXML is string
Res is boolean
DocXML is xmlDocument


// Chargement du contenu XML
DocXML = XMLOpen("exemple.xml", fromFile)

// Modification du document XML
...

// Récupération et mise en forme du document XML
SourceXML = DocXML.BuildString()

// Enregistrement du fichier XML
fSaveText("ExampleModifié.xml", SourceXML)

Syntax

Retrieving the source of an XML document found in an xmlDocument variable Hide the details

<Result> = <XML document>.BuildString([<Creation options>])

<Result>: Character string

Formatted XML document. This result can be:
handled in memory.
saved in a file in XML format by fSaveText.
...

<XML document>: Control name

xmlDocument variable containing the XML document to format.
Warning Result encoding corresponds to property Encoding property of variable xmlDocument. If no encoding is specified, the XML document will be encoded in UTF-8.

<Creation options>: Optional Integer constant

Combination of following values:
XMLDocumentDefault
(default value) Generates the XML code with a header and from the root.
XMLFormatting Generates XML code with formatting (indentation and carriage returns).
This constant is now available.
This constant is not available.
XMLNoHeader Generates the XML code without header.

Remarks

XML functions and threads

If your application uses threads, the XML document is shared between all these threads. For more details on threads, see Managing threads.

Component: wd300xml.dll