Xml.XMLDoc.TXMLNode.AddChild

Übergeordnet: TXMLNode

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;
function AddChild(const TagName, NamespaceURI: DOMString;  NodeClass: TXMLNodeClass; Index: Integer = -1): IXMLNode; overload;

C++

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

Eigenschaften

Typ	Sichtbarkeit	Quelle	Unit	Übergeordnet
function	protected	Xml.XMLDoc.pas Xml.XMLDoc.hpp	Xml.XMLDoc	TXMLNode

Beschreibung

Fügt dem Knoten einen neuen untergeordneten Knoten hinzu.

AddChild ist als protected deklariert und kann über das Interface IXMLNode des TXMLNode-Objekts aufgerufen werden. Dabei stehen aber nur die ersten beiden Syntaxvarianten zur Verfügung. Die dritte Variante wird von den TXMLNode-Nachkommen verwendet, die der Experte für XML-Datenbindungen erstellt.

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

TagName gibt den Tag-Namen des neuen Knotens an.

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.

NamespaceURI gibt den Namespace mit der Definition des neuen Knotens an. Ohne diesen Parameter (dritte Syntaxvariante) wird der Bereich 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.

NodeClass gibt die Implementierungsklasse des neuen Knotens an. Dabei muss es sich um TXMLNode oder eine abgeleitete Klasse handeln.

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.