SAX OUVRIR ELEMENT XML

4D - Documentation   Français   English   German   Español   Japanese   4D v11 SQL, Commandes par thèmes   4D v11 SQL, Liste alphabétique des commandes   4D v11 SQL, Constantes par thèmes   Retour   Précédent   Suivant

version 2004


SAX OUVRIR ELEMENT XML (document; balise{; nomAttribut; valeurAttribut}{; nomAttribut2; valeurAttribut2; ...; nomAttributN; valeurAttributN})

ParamètreTypeDescription
documentDocRefRéférence du document ouvert
baliseChaîneNom de l'élément à ouvrir
nomAttributChaîneNom d'attribut
valeurAttributChaîneValeur d'attribut

Description

La commande SAX OUVRIR ELEMENT XML permet d'ajouter un nouvel élément dans le document XML référencé par document ainsi que, facultativement, des attributs et leurs valeurs.

L'élément ajouté est "ouvert" dans le document (la balise de fin n'est pas ajoutée). Pour refermer un élément créé à l'aide de cette commande, vous devez soit :

utiliser la commande SAX FERMER ELEMENT XML,

refermer le document XML. Dans ce cas, 4D ajoute automatiquement les balises XML de fermeture nécessaires.

Passez dans balise le nom de l'élément à créer. Ce nom peut contenir uniquement des lettres, des chiffres, ainsi que les caractères ".", "-","_" et ":". Si un caractère invalide est passé dans balise, une erreur est générée.

Facultativement, la commande permet de passer un ou plusieurs couple(s) attributs/valeurs (sous forme de variables, champs ou valeur littérales) via les paramètres nomAttribut et valeurAttribut. Vous pouvez passer autant de couples attribut/valeur que vous voulez.

Exemple

L'instruction suivante :

   vElement:="Book"
   SAX OUVRIR ELEMENT XML($RefDoc;vElement)

... inscrira cette ligne dans le document :

<Book

Référence

SAX FERMER ELEMENT XML, SAX OUVRIR ELEMENT XML TABLEAUX.

Gestion des erreurs

Si un caractère invalide est passé dans balise, une erreur est générée.


4D - Documentation   Français   English   German   Español   Japanese   4D v11 SQL, Commandes par thèmes   4D v11 SQL, Liste alphabétique des commandes   4D v11 SQL, Constantes par thèmes   Retour   Précédent   Suivant