Xml.xmldom.IDOMNode.cloneNode

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche


Delphi

function cloneNode(deep: WordBool): IDOMNode; safecall;

C++

virtual HRESULT __safecall cloneNode(System::WordBool deep, _di_IDOMNode &__cloneNode_result) = 0 ;

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
function public
Xml.Xmldom.pas
Xml.xmldom.hpp
Xml.xmldom IDOMNode

Beschreibung

Gibt ein Duplikat dieses Knotens zurück.

Verwenden Sie cloneNode, um eine Kopie dieses Knotens abzurufen. Die Methode cloneNode gibt eine Kopie dieses Knotens zurück, die keinen übergeordneten Knoten aufweist. Auch alle Attribute werden kopiert, einschließlich der Attributknoten, die Standardwerte repräsentieren.

deep gibt an, ob auch die untergeordneten Knoten dieses Knotens repliziert werden sollen. Enthält ein Elementknoten beispielsweise Text, kopiert cloneNode Text nur, wenn deep den Wert true hat, da dieser Text in einem untergeordneten Knoten des Typs TEXT_NODE enthalten ist.

Anmerkung:  Beim direkten Replizieren eines Attributknotens (im Unterschied zum Kopieren der Attribute beim Replizieren eines Elementknotens) hat die Eigenschaft specified des zurückgegebenen Knotens immer den Wert true, auch wenn dieser Knoten kein specified-Attribut repräsentiert.

Anmerkung:  Das Replizieren eines unveränderlichen Teilbaums produziert eine veränderbare Kopie, die untergeordneten Knoten eines Entitätsreferenzknotens sind jedoch schreibgeschützt.

Anmerkung:  DOM-Implementierungen unterscheiden sich in der Art des Replizierens von Knoten der Typen DOCUMENT_NODE, DOCUMENT_TYPE_NODE, ENTITY_NODE und NOTATION_NODE.

Siehe auch