Aller au contenu principal
Version: Next

DOM SET XML ELEMENT NAME

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

ParamètreTypeDescription
refElémentTextRéférence d’élément XML
nomElémentTextNouveau 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