DOM SET XML ELEMENT NAME

DOM SET XML ELEMENT NAME ( refElément ; nomElément )

Paramètre	Type		Description
refElément	Text	→	Référence d’élément XML
nomElément	Text	→	Nouveau nom de l’élément

Description

La commande DOM SET XML ELEMENT NAME permet de modifier le nom de l’élément désigné par refElément.

Passez dans refElément la référence de l’élément à renommer et dans nomElément le nouveau nom de l’élément. Bien entendu, la commande se charge de modifier les balises d’ouverture et de fermeture de l’élément.

Exemple

Soit la source XML suivante :

<Book>
   <Title>The Best Seller</Title>
</Book>

Si le code suivant est exécuté, en admettant que vRefElem contienne la référence de l’élément ‘Book’ :

 DOM SET XML ELEMENT NAME(vRefElem;"BestSeller")

Nous obtenons :

<BestSeller>
   <Title>The Best Seller</Title>
</BestSeller>

Variables et ensembles système

Si la commande a été exécutée correctement, la variable système OK prend la valeur 1, sinon elle prend la valeur 0 et une erreur est générée.

Gestion des erreurs

Une erreur est générée lorsque :

• la référence de l’élément n’est pas valide
• le nouveau nom d’élément n’est pas valide (par exemple, s’il débute par un chiffre).

Voir aussi

DOM GET XML ELEMENT NAME

Propriétés

Numéro de commande	867
Thread safe	✓
Modifie les variables	OK, error