4D v16.3
DOM Append XML child node
- 4D - Langage
-
- XML DOM
-
- Présentation des commandes XML DOM
- DOM Append XML child node
- DOM Append XML element
- DOM CLOSE XML
- DOM Count XML attributes
- DOM Count XML elementsMod
- DOM Create XML element
- DOM Create XML element arrays
- DOM Create XML Ref
- DOM EXPORT TO FILE
- DOM EXPORT TO VAR
- DOM Find XML element
- DOM Find XML element by ID
- DOM Get first child XML element
- DOM Get last child XML element
- DOM Get next sibling XML element
- DOM Get parent XML element
- DOM Get previous sibling XML element
- DOM Get Root XML element
- DOM GET XML ATTRIBUTE BY INDEX
- DOM GET XML ATTRIBUTE BY NAME
- DOM GET XML CHILD NODES
- DOM Get XML document ref
- DOM GET XML ELEMENT NAME
- DOM GET XML ELEMENT VALUE
- DOM Get XML elementMod
- DOM Get XML information
- DOM Insert XML element
- DOM Parse XML source
- DOM Parse XML variable
- DOM REMOVE XML ATTRIBUTE
- DOM REMOVE XML ELEMENT
- DOM SET XML ATTRIBUTE
- DOM SET XML DECLARATION
- DOM SET XML ELEMENT NAME
- DOM SET XML ELEMENT VALUE
DOM Append XML child node
| DOM Append XML child node ( refElément ; typeEnfant ; valeurEnfant ) -> Résultat | ||||||||
| Paramètre | Type | Description | ||||||
| refElément | Texte |
|
Référence d’élément XML | |||||
| typeEnfant | Entier long |
|
Type d’enfant à ajouter | |||||
| valeurEnfant | Texte, BLOB |
|
Texte ou variable (Texte ou BLOB) dont la valeur doit être insérée en tant que noeud enfant | |||||
| Résultat | Texte |
|
Référence de l’élément XML enfant | |||||
La commande DOM Append XML child node 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 comment | Entier long | 2 |
| XML DATA | Entier long | 6 |
| XML DOCTYPE | Entier long | 10 |
| XML ELEMENT | Entier long | 11 |
| XML processing instruction | 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 Create XML element(refElement;"monElement")
DOM SET XML ELEMENT VALUE(Reference ;"Bonjour")
temp:=DOM Create XML element(Reference ;"br")
temp:=DOM Append XML child node(Reference;XML DATA;"La")
temp:=DOM Create XML element(Reference;"br")
temp:=DOM Append XML child node(Reference;XML DATA;"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 Append XML child node(refElement;XML Processing Instruction;$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 Append XML child node(refElement;XML Comment;"Hello world")Résultat :
<!--Hello world-->
Ajout d’un noeud de type CDATA :
Reference:=DOM Append XML child node(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 Append XML child node(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 Append XML child node(refElement;XML ELEMENT;"<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 Append XML child node(refElement;XML ELEMENT;"tbreak")
Résultat :<parent> <tbreak/> </parent>
Si le contenu de valeurEnfant est invalide, une erreur est retournée.
Produit : 4D
Thème : XML DOM
Numéro :
1080
Créé : 4D v12
4D - Langage ( 4D v16)
4D - Langage ( 4D v16.1)
4D - Langage ( 4D v16.2)
4D - Langage ( 4D v16.3)
