TXMLWriter.AddClosedDataNode
| TXMLWriter = class (TObject) | Interface de TXMLWriter | Exemples de TXMLWriter |
Qubes 6.3 Ajoute un sous-noeud avec un contenu encapsulé dans un CDATA
Syntaxe
procedure AddClosedDataNode(name: String; cdata: String)
Remarques
Ajoute un noeud dont le contenu sera encapsulé tel quel dans une section CDATA (i.e. encadré par "<![CDATA[" et "]]>").
Ce contenu ne sera donc pas interprété/décodé par le parseur XML lors de la lecture du XML.
Cela permet par exemple d'intégrer du HTML ou du XML dans un noeud XML, sans que les caractères spéciaux ("<", ">", "&"...) soient remplacés (par "<", ">", "&"...).
NB : Du fait de la section CDATA, il ne faut pas que les données contiennent la chaîne "]]>".
Et du fait du XML, il ne faut pas non plus qu'elles contiennent un caractère interdit dans le XML.
Ainsi, le CDATA ne permet pas de transmettre du binaire tel quel : il faudra plutôt l'encoder en hexadecimal ou en base64.
L'intérêt des sections CDATA réside essentiellement dans un éventuel gain en nombre de caractères si les données contiennent beaucoup de caractères réservés (le gain doit compenser la perte induite par les délimiteurs de section).
Mais dans le cas général, il faut plutôt utiliser AddClosedNode.
Exemples
Cf. Examples