version 2004 (Modifiée)
DOM LIRE ATTRIBUT XML PAR NOM (refElément; nomAttribut; valeurAttribut)
Paramètre | Type | Description | |
refElément | Chaîne | Référence d'élément XML | |
nomAttribut | Chaîne | Nom d'attribut | |
valeurAttribut | Variable | Valeur de l'attribut |
Description
La commande DOM LIRE ATTRIBUT XML PAR NOM permet de connaître la valeur d'un attribut désigné par son nom.
Passez dans refElément la référence d'un élément XML et dans nomAttribut le nom d'attribut dont vous voulez connaître la valeur. La valeur est retournée dans le paramètre valeurAttribut.
4D tentera de convertir la valeur obtenue dans le type de la variable passée en paramètre.
Si aucun attribut nomAttribut n'existe dans l'élément XML, une erreur est retournée. Si plusieurs attributs de l'élément XML portent le nom spécifié, seule la valeur du premier attribut est retournée.
Exemple
Cette méthode permet de récupérer une valeur d'attribut XML à l'aide de son nom :
C_BLOB(maVarBlob) C_ALPHA(16;$ref_XML_Parent;$ref_XML_Enfant) C_ENTIER LONG($NumLigne) $ref_XML_Parent:=DOM Analyser variable XML(maVarBlob) $ref_XML_Enfant:=DOM Lire premier element XML enfant($ref_XML_Parent) DOM LIRE ATTRIBUT XML PAR NOM($ref_XML_Enfant;"N";$NumLigne)
Si cette méthode est appliquée à l'exemple ci-dessous, $NumLigne contient la valeur 1 :
Référence
DOM LIRE ATTRIBUT XML PAR INDEX.
Variables et ensembles système
Si la commande a été correctement exécutée, la variable système OK prend la valeur 1. Si une erreur se produit, elle prend la valeur 0.