Xml.XMLIntf.IXMLDocument.CreateNode
Delphi
function CreateNode(const NameOrData: DOMString;
NodeType: TNodeType = ntElement; const AddlData: DOMString = ''): IXMLNode;
C++
virtual _di_IXMLNode __fastcall CreateNode(const System::UnicodeString NameOrData, TNodeType NodeType = (TNodeType)(0x1), const System::UnicodeString AddlData = System::UnicodeString()) = 0 ;
Propriétés
Type | Visibilité | Source | Unité | Parent |
---|---|---|---|---|
function | public | Xml.XMLIntf.pas Xml.XMLIntf.hpp |
Xml.XMLIntf | IXMLDocument |
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).
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.