XMLInsertElement (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Functions for managing XML files

Prefixed syntax

XMLInsertElement

Presentation

Saving the modifications in the XML file

See also

Constants for managing XML documents

Example for using the XML types

XML management: Use example

XML: Using files exceeding several gigabytes

XMLFindNamespaceByName

XMLFindNamespaceByURI

Saving the modifications in the XML file

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

XMLInsertElement (Function)

In french: XMLInsèreElement

Inserts an XML element (tag or attribute) into an XML document. The insertion position is relative to the current position.

Versions 25 and later

This function is now available in browser code.

New in version 25

This function is now available in browser code.

Syntax

<Result> = XMLInsertElement(<XML document> , <Element name> [, <Value of inserted element> [, <Insertion position> [, <Change of position>]]])

<Result>: Boolean

True if the insertion was performed,
False otherwise (the ErrorOccurred variable is set to True).
To find out the error details, use ErrorInfo.

<XML document>: Character string with quotes

XML document into which the insertion will be performed.

<Element name>: Character string with quotes

Name of element to add. The added element and the current element have the same type:
If the current element is a tag, the inserted element is a tag.
If the current element is an attribute, the inserted element is an attribute.

<Value of inserted element>: Optional character string with quotes

Value of new element. This parameter corresponds to an empty string ("") by default.

<Insertion position>: Optional Integer constant

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

<Change of position>: Optional boolean

True to be positioned on the added element. In this case, the added element becomes the current position.
False (default value) to avoid modifying the current position during the addition.

Remarks

Saving the modifications in the XML file

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

Use XMLBuildString. 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 fSaveText.

Example:

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

Business / UI classification : Business Logic

Component : wd260xml.dll