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 ;
Eigenschaften
Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
---|---|---|---|---|
function | public | Xml.XMLIntf.pas Xml.XMLIntf.hpp |
Xml.XMLIntf | IXMLDocument |
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.
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.