Xml.XMLIntf.IXMLNode.AddChild
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 */;
プロパティ
種類 | 可視性 | ソース | ユニット | 親 |
---|---|---|---|---|
function | public | Xml.XMLIntf.pas Xml.XMLIntf.hpp |
Xml.XMLIntf | IXMLNode |
説明
このノードに新しい子ノードを追加します。
AddChild は,このノードの子として新しい要素ノードを作成します。
TagName は,新しく作成されたノードのタグ名を提供します。
NamespaceURI は,新しいノードの定義が含まれる名前空間を識別します。NamespaceURI を省略した場合(2 つめの構文),新しいノードの名前空間は TagName の名前空間プレフィクスから推定されます。TagName に名前空間プレフィクスがなく,NamespaceURI パラメータも指定されていない場合,名前空間はこのノードの NamespaceURI プロパティと同じになります。
GenPrefix は,NamespaceURI パラメータがドキュメントでまだ宣言されていない URI を識別する場合に,AddChild が名前空間 URI の名前空間プレフィクスを生成するかどうかを制御します。GenPrefix を true に設定しても,ドキュメントの Options プロパティに doNamespaceDecl が含まれていない限りは AddChild は新しい名前空間プレフィクスの宣言を追加しません。
Index は,このノードの子リストにおける新しい子ノードの位置を示します。0 は先頭,1 は 2 番めの位置です。Index が -1 の場合,新しいノードは最後に追加されます。
AddChild は,新しく作成された子ノードのインターフェースを返します。
ヒント: AddChild は,要素ノードを追加するだけです。ほかの種類の子ノードを追加するには,かわりに XML ドキュメントの CreateNode メソッドを使用し,作成されたノードを ChildNodes プロパティ配列に追加します。