SAX LIRE ELEMENT XML

4D v16.3


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

Paramètre	Type	Description
document	RefDoc	Référence du document ouvert
nom	Chaîne	Nom de l’élément
préfixe	Chaîne	Espace de nommage
nomsAttributs	Tableau chaîne	Noms des attributs
valeursAttributs	Tableau chaîne	Valeurs 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 XML début élément ou XML fin élément. Dans le cas particulier d’un XML fin élément, 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”

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.

Voir aussi

SAX Lire noeud XML