Xml.XMLDoc.TXMLDocument.CreateNode

De RAD Studio API Documentation
Aller à : navigation, rechercher

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.

Voir aussi

Exemples de code