Xml.XMLIntf.IXMLNode.AddChild

Übergeordnet: IXMLNode

Delphi

function AddChild(const TagName: DOMString; Index: Integer = -1): IXMLNode; overload;
function AddChild(const TagName, NamespaceURI: DOMString;  GenPrefix: Boolean = False; Index: Integer = -1): IXMLNode; overload;

C++

virtual _di_IXMLNode __fastcall AddChild(const System::UnicodeString TagName, int Index = 0xffffffff) = 0 /* overload */;
virtual _di_IXMLNode __fastcall AddChild(const System::UnicodeString TagName, const System::UnicodeString NamespaceURI, bool GenPrefix = false, int Index = 0xffffffff) = 0 /* overload */;

Eigenschaften

Typ	Sichtbarkeit	Quelle	Unit	Übergeordnet
function	public	Xml.XMLIntf.pas Xml.XMLIntf.hpp	Xml.XMLIntf	IXMLNode

Beschreibung

Fügt dem Knoten einen neuen untergeordneten Knoten hinzu.

AddChild erzeugt einen neuen Elementknoten, der dem Knoten untergeordnet ist.

TagName gibt den Tag-Namen des neuen Knotens an.

NamespaceURI gibt den Namespace mit der Definition des neuen Knotens an. Wenn NamespaceURI nicht angegeben wird (zweite Syntaxvariante), wird der Namespace des neuen Knotens aus dem Namespace Präfix von TagName abgeleitet. Wenn TagName kein Präfix hat und der Parameter nicht angegeben wird, ist der Namespace mit der Eigenschaft NamespaceURI des Knotenobjekts identisch.

GenPrefix bestimmt, ob AddChild ein Namespace-Präfix für den Namespace-URI generiert, wenn im Parameter NamespaceURI ein im Dokument noch nicht deklarierter URI übergeben wird. Auch wenn GenPrefix den Wert true hat, wird nur dann eine Deklaration für das neue Namespace-Präfix hinzugefügt, wenn die Eigenschaft Options des Dokuments den Wert doNamespaceDecl enthält.

Index gibt die Position des neuen Knotens in der Liste der untergeordneten Knoten an (0 ist die erste Position, 1 die zweite usw.). Hat Index den Wert -1, wird der Knoten am Ende der Liste hinzugefügt.

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

Tip: Mit AddChild können nur Elementknoten hinzugefügt werden. Wenn Sie andere Arten von untergeordneten Knoten hinzufügen möchten, verwenden Sie die Methode CreateNode des XML-Dokuments, und fügen Sie den neuen Knoten dann der ChildNodes-Liste hinzu.