XMLInsertDocument (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

XML file management functions

Saving the modifications in the XML file

See also

Constants for managing XML documents

Modifying an SVG image (XML functions)

TextToXML

Usage example of the XML types

XML functions

XML management: Use example

XML: Using files exceeding several gigabytes

XMLAddAttribute

XMLAddChild (Example)

XMLAddChild

XMLBuildString (Example)

XMLDocument (Example)

XMLDocument

XMLElementName (Example)

XMLElementName

XMLElementType

XMLExecuteXPath (Example)

XMLFindNamespaceByName

XMLFindNamespaceByURI

XMLOpenReader (Example)

XMLRestorePosition (Example)

XMLSavePosition (Example)

Saving the modifications in the XML file

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

XMLInsertDocument (Function)

In french: XMLInsèreDocument

Inserts the current XML tag found in an XML document into another XML document.

An XML document can only contain a single tag at its root.

Example

Result1 is boolean
// Inserts the current tag found in MySourceDoc into MyTargetDoc
// This tag will be a child tag of the current tag found in MyTargetDoc
Result1 = XMLInsertDocument("MyTargetDoc", "MySourceDoc", XMLChildItem)
IF Result1 = True THEN
Info("Insertion successful")
ELSE
Info("The insertion failed")
END

Syntax

<Result> = XMLInsertDocument(<Target XML document> , <Source XML document> [, <Insertion position>])

<Result>: Boolean

True if the insertion is performed,
False otherwise (the ErrorOccurred variable is set to True).
To get more details on the error, use ErrorInfo.

<Target XML document>: Character string

Name of XML document into which the insertion will be performed.

<Source XML document>: Character string

Name of XML document containing the tag that will be inserted into an XML document.

<Insertion position>: Optional Integer constant

Position where the addition is performed in relation to the current tag in <Target XML document>. This parameter can take one of the following values:
XMLChildItem The insertion is performed in the current level. The inserted part will be a child tag of the current tag.
XMLNextElement
(Default value) The insertion is performed just after the current tag, in the same branch.
XMLPreviousElement The insertion is performed just before the current tag, in the same branch.

Remarks

Saving the modifications in the XML file

To save the modifications performed in an XML file, you must:

Use the XMLBuildString function. This function retrieves and formats the content of an XML document.
Save the character string generated by XMLBuildString in an XML file. To do so, use the fSaveText function.

Example:

// Once the XML document was modified
XMLSource = XMLBuildString("XMLDoc")
// Save the XML file
fSaveText("ModifiedExample.xml", XMLSource)

Business / UI classification: Business Logic

Component: wd270xml.dll