SAX LIRE ELEMENT XML

4D - Documentation   Français   English   German   4e Dimension, Commandes par thèmes   4e Dimension, Liste alphabétique des commandes   4e Dimension, Constantes par thèmes   Retour   Précédent   Suivant

version 2004


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

ParamètreTypeDescription
documentDocRefRéférence du document ouvert
nomChaîneNom de l'élément
préfixeChaîneEspace de nommage
nomsAttributsTab chaîneNoms des attributs
valeursAttributsTab chaîneValeurs des attributs

Description

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.

Exemple

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"

Référence

SAX Lire noeud XML.

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.


4D - Documentation   Français   English   German   4e Dimension, Commandes par thèmes   4e Dimension, Liste alphabétique des commandes   4e Dimension, Constantes par thèmes   Retour   Précédent   Suivant