Xml.xmldom.IDOMNode.replaceChild
Delphi
function replaceChild(const newChild, oldChild: IDOMNode): IDOMNode; safecall;
C++
virtual HRESULT __safecall replaceChild(const _di_IDOMNode newChild, const _di_IDOMNode oldChild, _di_IDOMNode &__replaceChild_result) = 0 ;
Eigenschaften
| Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
|---|---|---|---|---|
| function | public | Xml.Xmldom.pas Xml.xmldom.hpp |
Xml.xmldom | IDOMNode |
Beschreibung
Ersetzt einen untergeordneten Knoten dieses Knotens durch den angegebenen Knoten.
Verwenden Sie replaceChild, um einen untergeordneten Knoten dieses Knotens zu entfernen und durch den in newChild angegebenen Knoten zu ersetzen. 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, ist refChild ein Knoten, der sich nicht in der Liste untergeordneter Knoten dieses Knotens befindet, wurde newChild unter Verwendung eines anderen Dokuments erstellt oder weist newChild in seiner Eigenschaft nodeType einen Wert auf, der für untergeordnete Knoten dieses Knotens nicht zulässig ist, löst replaceChild eine Exception aus.
newChild ist der untergeordnete Knoten, der oldChild ersetzt. 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.
refChild ist ein untergeordneter Knoten, der durch den in newChild angegebenen Knoten ersetzt wird. Hat refChild den Wert nil (Delphi) bzw. NULL (C++), wird der neue Knoten am Ende der Liste untergeordneter Knoten hinzugefügt.
replaceChild gibt die Schnittstelle für refChild (der ersetzte Knoten) zurück.