XMLData (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

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

Identifying the current element
XML functions and threads

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

XMLData (Function)

In french: XMLDonnée

Returns the value of current element (tag or XML attribute) or the value of one of its attributes.

To select an element, use the functions for XML search and browse (XMLFirst, XMLLast, XMLChild, ...).

Example

See additional examples

// Valeur de l'attribut "Produit" de l'élément en cours
Valeur is string
Valeur = XMLData("DocXML", "Produit")

// Test de la valeur
IF Valeur = "" THEN
	Error("L'attribut Produit n'a pas de valeur")
ELSE
	Info("La valeur de l'attribut Produit est : " + Valeur)
END

// Valeur d'une balise
Valeur is string
Valeur = XMLData("DocXML")

// Positionné sur une balise ?
IF ErrorOccurred = True THEN
	Error(ErrorInfo())
ELSE
	// Test de la valeur
	IF Valeur = "" THEN
		Error("L'élément en cours n'a pas de valeur")
	ELSE
		Info("La valeur de l'élément courant est : " + Valeur)
	END
END

Syntax

<Result> = XMLData(<XML document> [, <Attribute> [, <Search mode>]])

<Result>: Character string

Value of current element or value of specified attribute.
Empty string (""):
if the current element has no value.
if the specified attribute is not a child of the current element.
if there is no current element. In this case, the ErrorOccurred variable is set to True. To get more details on the error, use ErrorInfo.
if the current element is already an attribute. In this case, the ErrorOccurred variable is set to True. To get more details on the error, use ErrorInfo.

<XML document>: Character string

Name of the XML document used. This document contains the XML code to study and it was created by XMLDocument.

<Attribute>: Optional character string

Name of child attribute of current tag for which the value must be returned. This attribute is sought among the direct children of current element. If this parameter is not specified (or if it corresponds to Null or an empty string), XMLData returns the value of the current tag.

<Search mode>: Optional Integer constant

Search mode use to find the attribute among the children of current element.
XMLContains Search for the first attribute whose name contains the value of <Attribute>.
XMLExact
(Default value) Search for the first attribute whose name exactly corresponds to the value of <Attribute>.
XMLIgnoreCase Search for the first attribute whose name corresponds to the value of <Attribute> regardless of the case.
Can be combined with the constants XMLContains, XMLStartWith or XMLExact.
XMLStartWith Search for the first attribute whose name starts with the content of <Attribute>.

Remarks

Identifying the current element

The type of current element is returned by XMLElementType.
The name of current element is returned by XMLElementName.

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