Xml.xmldom.IDOMNode.appendChild
Delphi
function appendChild(const newChild: IDOMNode): IDOMNode; safecall;
C++
virtual HRESULT __safecall appendChild(const _di_IDOMNode newChild, _di_IDOMNode &__appendChild_result) = 0 ;
Eigenschaften
Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
---|---|---|---|---|
function | public | Xml.Xmldom.pas Xml.xmldom.hpp |
Xml.xmldom | IDOMNode |
Beschreibung
Fügt dem Knoten einen neuen untergeordneten Knoten hinzu.
Verwenden Sie appendChild, um am Ende der Liste der untergeordneten Knoten dieses Knotens einen untergeordneten Knoten hinzuzufügen. Befindet sich der neue Knoten bereits in der Hierarchie des Dokumentknotens, wird er zunächst aus der Hierarchie seines übergeordneten Knotens entfernt. Ist dieser Knoten schreibgeschützt, wurde newChild für ein anderes Dokument erstellt oder - wenn newChild einen Wert für nodeType aufweist, der für untergeordnete Komponenten dieses Knotens nicht zulässig ist - appendChild löst eine Exception aus.
newChild ist der hinzuzufügende untergeordnete Knoten. Es kann sich um einen Knoten handeln, der derzeit einen anderen übergeordneten Knoten aufweist, oder um einen neuen Knoten, der mit den Methoden der Dokumentschnittstelle erstellt wurde. Weist der Knoten in der Eigenschaft nodeType den Wert DOCUMENT_FRAGMENT_NODE auf, wird der gesamte Inhalt des Dokumentfragments in die Eigenschaftsliste childNodes dieses Knotens verschoben.
appendChild gibt die Schnittstelle für den neu hinzugefügten untergeordneten Knoten zurück.