Xml.XMLIntf.IXMLNode.AddChild

From RAD Studio API Documentation
Jump to: navigation, search

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 */;

Properties

Type Visibility Source Unit Parent
function public
Xml.XMLIntf.pas
Xml.XMLIntf.hpp
Xml.XMLIntf IXMLNode

Description

Adds a new child node to this node.

AddChild creates a new element node as the child of this node.

TagName provides the tag name of the newly created node.

NamespaceURI identifies the namespace that includes the new node's definition. If NamespaceURI is omitted (the second syntax), the namespace of the new node is deduced from the namespace prefix of TagName. If TagName has no namespace prefix and there is no NamespaceURI parameter, the namespace is the same as this node's NamespaceURI property.

GenPrefix controls whether AddChild generates a namespace prefix for the namespace URI when the NamespaceURI parameter identifies a URI that is not already declared in the document. Note that setting GenPrefix to true does not cause AddChild to add a declaration of the new namespace prefix unless the document's Options property includes doNamespaceDecl.

Index indicates the position of the child node in this node's list of children, where 0 is the first position, 1 is the second position, and so on. If Index is –1, the new node is added to the end.

AddChild returns the interface for the newly created child node.

Tip: AddChild only adds element nodes. To add other types of child nodes, use the XML document's CreateNode method instead, and then add the resulting node to the ChildNodes property array.

See Also