SAX LIRE ELEMENT XML

version 2004

SAX LIRE ELEMENT XML (document; nom; préfixe; nomsAttributs; valeursAttributs)

La commande SAX LIRE ELEMENT XML retourne diverses informations relatives à l'élément nom présent dans le document XML référencé par document. Elle doit être appelée dans le contexte d'un événement SAX Début élément XML ou Fin élément XML. Dans le cas particulier d'un Fin élément XML, les paramètres d'attributs ne sont pas gérés. Pour plus d'informations sur les événements SAX, reportez-vous à la description de la commande SAX Lire noeud XML.

nom contient le nom de l'élément.

préfixe retourne l'espace de nommage (namespace) de l'élément. Ce paramètre est vide si aucun espace de nommage n'est associé à l'élément.

La commande remplit le tableau nomsAttributs avec les noms des attributs de l'élément cible. Si nécessaire, la commande crée et dimensionne automatiquement le tableau.

La commande remplit également le tableau valeursAttributs avec les valeurs des attributs de l'élément cible. Si nécessaire, la commande crée et dimensionne automatiquement le tableau.

Considérons l'extrait de code XML suivant :

<RootElement>
   <Child Att1="111" Att2="222" Att3="333">MonTexte</Child>
</RootElement>

Une fois l'instruction suivante exécutée :

   SAX LIRE ELEMENT XML (RefDoc;vNom;vPréfixe;tAttrNoms;tAttrValeurs)

...vNom contiendra "Child"

vPréfixe contiendra ""

tAttrNoms{1} contiendra "Att1", tAttrNoms{2} contiendra "Att2", tAttrNoms{3} contiendra "Att3"

tAttrValeurs{1} contiendra "111", tAttrValeurs{2} contiendra "222", tAttrValeurs{3} contiendra "333"

SAX Lire noeud XML.

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.