Xml.XMLDoc.TXMLDocument.CreateNode

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

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());

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
function public
Xml.XMLDoc.pas
Xml.XMLDoc.hpp
Xml.XMLDoc TXMLDocument

Beschreibung

Erstellt einen neuen Knoten für das Dokument.

Mit CreateNode erstellen Sie einen neuen generischen XML-Knoten. Der neue Knoten hat kein übergeordnetes Element, kann aber in die Listen ChildNodes oder AttributeNodes eines beliebigen Knotens im Dokument (auch des Dokuments selbst) aufgenommen werden. Der Knoten kann auch der Eigenschaft DocumentElement zugewiesen werden, um die gesamte Datenhierarchie des Dokuments zu ersetzen.

NameOrData ist der Tag-Name oder der Wert des neuen Knotens. Die genaue Bedeutung des Parameters hängt vom jeweiligen Knotentyp (NodeType) ab:



NodeType NameOrData

ntElement

Der Tag-Name.

ntAttribute

Der Name des Attributs.

ntText

Der Wert des Knotens.

ntCData

Der Inhalt des CDATA-Abschnitts.

ntEntityRef

Der Name der referenzierten Entität.

ntProcessingInstr

Das Ziel der Verarbeitungsanweisung.

ntComment

Der Wert (Text) des Kommentars.

ntDocFragment

Wird nicht verwendet.

ntElement

Der Namespace-URI für den Tag-Namen.

ntAttribute

Der Namespace-URI für den Attributnamen.

ntProcessingInstr

Der Inhalt der Verarbeitungsanweisung (mit Ausnahme des Ziels).



NodeType legt den Typ des zu erzeugenden Knotens fest. Zulässig sind nur die in der obigen Tabelle aufgeführten Typen.

Die Bedeutung von AddlData hängt vom angegebenen Knotentyp ab:



NodeType AddlData

ntElement

Der Namespace-URI für den Tag-Namen.

ntAttribute

Der Namespace-URI für den Attributnamen.

ntProcessingInstr

Der Inhalt der Verarbeitungsanweisung (mit Ausnahme des Ziels).



CreateNode gibt das Interface für den neuen Knoten zurück.

Anmerkung:  Wenn Sie einen Knoten einem anderen Knoten als untergeordnetes Element hinzufügen möchten, verwenden Sie dessen Methode AddChild.

Siehe auch

Code-Beispiele