XMLAddAttribute (Function)

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

Functions for managing XML files

Managing the addition

Saving the modifications in the XML file

XML functions and threads

See also

XMLAddAttribute (Function)

In french: XMLAjouteAttribut

Adds an attribute into an XML document. This attribute is added at the end of list of attributes for the current position.

The list of attributes is sorted in alphabetical order. Therefore, this attribute is added according to the alphabetical order.

Versions 17 and later

This function is now available for Android applications.

This function is now available for iPhone/iPad applications.

New in version 17

This function is now available for Android applications.

This function is now available for iPhone/iPad applications.

This function is now available for Android applications.

This function is now available for iPhone/iPad applications.

Versions 18 and later

This function is now available in Android Widget mode.

This function is now available in Windows Store apps mode.

New in version 18

This function is now available in Android Widget mode.

This function is now available in Windows Store apps mode.

This function is now available in Android Widget mode.

This function is now available in Windows Store apps mode.

Versions 21 and later

This function is now available in Universal Windows 10 App mode.

New in version 21

This function is now available in Universal Windows 10 App mode.

Example

// Add a new order line
XMLParent("XMLOrd")
XMLAddChild("XMLOrd", "orderline", "", True)
XMLAddAttribute("XMLOrd", "number", "2")

// Add the "productcode" tag
XMLAddChild("XMLOrd", "productcode", "sro2125")

// Add the "description" tag
XMLAddChild("XMLOrd", "description", "optical mouse")

// Add the "quantity" tag
XMLAddChild("XMLOrd", "quantity", "15")

Syntax

XMLAddAttribute(<Name of XML document> , <Attribute name> [, <Attribute value> [, <Change of position>]])

<Name of XML document>: : Character string (with quotes)

Name of the XML document into which the addition must be performed. This document contains the XML code and it was created by XMLDocument.

<Attribute name>: Character string (with quotes)

Name of the attribute to add.
Versions 17 and later
Caution: You cannot create elements (tag or attribute) with accented characters.
New in version 17
Caution: You cannot create elements (tag or attribute) with accented characters.
Caution: You cannot create elements (tag or attribute) with accented characters.

<Attribute value>: Optional character string (with quotes)

Value of the new attribute. This parameter corresponds to an empty string by default.

<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

Managing the addition

If the current position is an attribute, the new attribute is added at the end of the current list of attributes.
The current position in the document does not change when XMLAddAttribute is called (except if <Change of position> is set to True).

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)

XML functions and threads

If your application uses threads, the XML document is shared between all these threads. See Managing threads for more details.

Component : wd240xml.dll