PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Home | Sign in | English US
  • Managing the addition
  • Saving the modifications in the XML file
  • XML functions and threads
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
XMLAddChild (Function)
In French: XMLAjouteFils
Adds a child tag into an XML document. This child tag is added at the end of the list of attributes for the current position.
Versions 17 and later
iPhone/iPad This function is now available for the iPhone/iPad applications.
New in version 17
iPhone/iPad This function is now available for the iPhone/iPad applications.
iPhone/iPad This function is now available for the iPhone/iPad applications.
Versions 18 and later
Android Widget This function is now available in Android Widget mode.
Universal Windows 10 App This function is now available in Windows Store apps mode.
New in version 18
Android Widget This function is now available in Android Widget mode.
Universal Windows 10 App This function is now available in Windows Store apps mode.
Android Widget This function is now available in Android Widget mode.
Universal Windows 10 App This function is now available in Windows Store apps mode.
Versions 21 and later
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
New in version 21
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
// 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
XMLAddChild(<Name of XML Document> , <Tag Name> [, <Tag Value> [, <Change of Position> [, <Option>]]])
<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.
<Tag Name>: Character string (with quotes)
Name of the tag to add. If this parameter corresponds to the CDATA constant, the content of the CDATA tag will not be interpreted by the XML parser. You have the ability to include an image in binary format in this tag. Caution: the encoding used must respect the encoding of the XML document.
Windows Mobile When using the CDATA parameter, a Buffer variable must be used.
AndroidAndroid Widget Caution: You cannot create elements (tag or attribute) with accented characters.
<Tag Value>: Optional character string (with quotes)
Value of the new tag. 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.
<Option>: Optional Integer constant
Addition options. The possible values are:
XMLEncodingAmpersandIf the "&" character (ampersand) is found in the value of the added tag, it will be encoded in "&amp;" format.
If this option value is not specified, the "&" character will be kept without modification.
Remarks

Managing the addition

  • If the current position is an attribute, the new tag is added at the end of the current list of child tags for the tag that contains the attribute.
  • The current position in the document does not change during the call to XMLAddChild except if <Change of Position> is set to True.
Note: XMLDocument creates no root for the document. To create a first child element in an empty document, this document must necessarily contain a root.
WINDEVWEBDEV - Server codeReports and QueriesAndroidAndroid Widget Windows MobileUniversal Windows 10 AppJavaPHPAjaxUser code (UMC)

Saving the modifications in the XML file

To save the modifications performed in an XML file, you must:
  1. Use XMLBuildString. This function retrieves and formats the content of an XML document.
  2. 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 is using threads, the XML document is shared among all these threads. See Managing the threads for more details.
Components
WINDEVWEBDEV - Server codeReports and Queries wd230xml.dll
Windows Mobile wp230xml.dll
WEBDEV - Browser code WDJS.DLL
Java wd230java.jar
Linux wd230xml.so
Android wd230android.jar
Minimum required version
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment