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