Xml.XMLDoc.TXMLDocument.CreateNode
Delphi
function CreateNode(const NameOrData: DOMString; NodeType: TNodeType = ntElement; const AddlData: DOMString = ''): IXMLNode;
C++
Xml::Xmlintf::_di_IXMLNode __fastcall CreateNode(const System::UnicodeString NameOrData, Xml::Xmlintf::TNodeType NodeType = (Xml::Xmlintf::TNodeType)(0x1), const System::UnicodeString AddlData = System::UnicodeString());
Propriétés
| Type | Visibilité | Source | Unité | Parent |
|---|---|---|---|---|
| function | public | Xml.XMLDoc.pas Xml.XMLDoc.hpp |
Xml.XMLDoc | TXMLDocument |
Description
Crée un noeud associé à ce document.
Appelez CreateNode pour créer un nouveau noeud d'élément XML. Le noeud obtenu ne possède pas de parent mais peut être ajouté à la liste ChildNodes ou AttributeNodes de tout noeud du document (notamment la propriété ChildNodes de celui-ci). Il peut également être affecté à la propriété DocumentElement afin de remplacer toute la hiérarchie de données de ce document.
NameOrData fournit le nom de balise ou la valeur du noeud créé. Son interprétation dépend du type de noeud créé, comme l'explique le tableau suivant :
| NodeType | NameOrData |
|---|---|
|
ntElement |
Nom de balise. |
|
ntAttribute |
Nom d'attribut. |
|
ntText |
Valeur du noeud. |
|
ntCData |
Valeur de la section CDATA. |
|
ntEntityRef |
Nom de l'entité référencée. |
|
ntProcessingInstr |
Cible de l'instruction de traitement. |
|
ntComment |
Valeur (texte) du commentaire. |
|
ntDocFragment |
Inutilisé. |
|
ntElement |
URI d'espace de nommage qui qualifie le nom de balise. |
|
ntAttribute |
URI d'espace de nommage qui qualifie le nom d'attribut. |
|
ntProcessingInstr |
Contenu de l'instruction de traitement, à l'exception de la cible. |
NodeType indique le type de noeud à créer. Celui-ci doit être l'un des types répertoriés dans le tableau précédent.
La signification de AddlData dépend du type de noeud, comme l'explique le tableau suivant :
| NodeType | AddlData |
|---|---|
|
ntElement |
URI d'espace de nommage qui qualifie le nom de balise. |
|
ntAttribute |
URI d'espace de nommage qui qualifie le nom d'attribut. |
|
ntProcessingInstr |
Contenu de l'instruction de traitement, à l'exception de la cible. |
CreateNode renvoie l'interface du nouveau noeud.
Remarque : Pour ajouter un noeud comme enfant d'un autre noeud dans ce document, il est plus simple d'appeler la méthode AddChild de ce noeud.