SAX GET XML ELEMENT

4D v20.6

SAX GET XML ELEMENT


SAX GET XML ELEMENT ( 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 GET XML ELEMENT 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 start element ou XML end element. Dans le cas particulier d’un XML end element, 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 Get XML node.

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 GET XML ELEMENT(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 Get XML node