4D v16.3

DOM Ajouter noeud enfant XML

Accueil

 
4D v16.3
DOM Ajouter noeud enfant XML

DOM Ajouter noeud enfant XML 


 

DOM Ajouter noeud enfant XML ( refElément ; typeEnfant ; valeurEnfant ) -> Résultat 
Paramètre Type   Description
refElément  Texte in Référence d’élément XML
typeEnfant  Entier long in Type d’enfant à ajouter
valeurEnfant  Texte, BLOB in Texte ou variable (Texte ou BLOB) dont la valeur doit être insérée en tant que noeud enfant
Résultat  Texte in Référence de l’élément XML enfant

La commande DOM Ajouter noeud enfant XML permet d’ajouter la valeur valeurEnfant au noeud XML désigné par refElément

Le type de noeud créé est défini par le paramètre typeEnfant. Passez dans ce paramètre l’une des constantes suivantes, placées dans le thème XML :

Constante Type Valeur
XML CDATA Entier long 7
XML commentaire Entier long 2
XML DOCTYPE Entier long 10
XML Donnée Entier long 6
XML Elément Entier long 11
XML instruction de traitement Entier long 3

Passez dans valeurEnfant les données à insérer. Vous pouvez passer une chaîne ou une variable 4D (chaîne ou BLOB). Le contenu de ce paramètre sera toujours converti en texte. 

Note : Si le paramètre refElément désigne le noeud Document (noeud de plus haut niveau), la commande insère un noeud "Doctype" avant tout autre noeud. Il en va de même pour les instructions de traitement et les commentaires, qui sont toujours insérés avant le noeud racine (mais après le noeud Doctype).

Ajout d’un noeud de type texte :

 Reference:=DOM Creer element XML(refElement;"monElement")
 DOM ECRIRE VALEUR ELEMENT XML(Reference ;"Bonjour")
 temp:=DOM Creer element XML(Reference ;"br")
 temp:=DOM Ajouter noeud enfant XML(Reference;XML Donnée;"La")
 temp:=DOM Creer element XML(Reference;"br")
 temp:=DOM Ajouter noeud enfant XML(Reference;XML Donnée;"France")

Résultat :

<monElement>Bonjour<br/>La<br/>France</monElement> 

Ajout d’un noeud de type instruction de traitement :

 $Txt_instruction:="xml-stylesheet type = \"text/xsl\" href=\"style.xsl\""
 Reference:=DOM Ajouter noeud enfant XML(refElement;XML instruction de traitement;$Txt_instruction )

Résultat (inséré avant le premier élément) :

<?xml-stylesheet type="text/xsl" href="style.xsl"?> 

Ajout d’un noeud de type commentaire :

 Reference:=DOM Ajouter noeud enfant XML(refElement;XML commentaire;"Hello world")

Résultat :

<!--Hello world-->

Ajout d’un noeud de type CDATA :

 Reference:=DOM Ajouter noeud enfant XML(refElement;XML CDATA;"12 < 18")

Résultat :

<element><![CDATA[12 < 18]]></element>

Ajout ou remplacement d’un noeud de type déclaration Doctype :

 Reference:=DOM Ajouter noeud enfant XML(refElement;XML DOCTYPE;"Books SYSTEM \"Book.DTD\"")

Résultat (inséré avant le premier élément) :

<!DOCTYPE Books SYSTEM "Book.DTD">

Ajout ou remplacement d’un noeud de type Elément.

  • si le paramètre valeurEnfant est un fragment XML, il est inséré en tant que noeuds enfants :
     Reference:=DOM Ajouter noeud enfant XML(refElement;XML Elément;"<child>simon</child><child>eva</child>")

    Résultat :
    <parent>
        <child>simon</child>
        <child>eva</child>
    </parent>
  • sinon, un nouvel élément enfant vide est ajouté :
     Reference:=DOM Ajouter noeud enfant XML(refElement;XML Elément;"tbreak")

    Résultat :
    <parent>
         <tbreak/>
     </parent>

Si le contenu de valeurEnfant est invalide, une erreur est retournée.



Voir aussi  

DOM LIRE NOEUDS ENFANTS XML
DOM Lire ref document XML

 
PROPRIÉTÉS 

Produit : 4D
Thème : XML DOM
Numéro : 1080
Nom intl. : DOM Append XML child node

Commande(s) éligible(s) à l'exécution dans un process préemptif

 
HISTORIQUE 

Créé : 4D v12

 
UTILISATION DE L'ARTICLE

4D - Langage ( 4D v16)
4D - Langage ( 4D v16.1)
4D - Langage ( 4D v16.2)
4D - Langage ( 4D v16.3)