IDocument.AdoptNode(INode) Methode

Definition

Namespace:: Org.W3c.Dom

Assembly:: Mono.Android.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Versucht, einen Knoten von einem anderen Dokument in dieses Dokument zu übernehmen.

[Android.Runtime.Register("adoptNode", "(Lorg/w3c/dom/Node;)Lorg/w3c/dom/Node;", "GetAdoptNode_Lorg_w3c_dom_Node_Handler:Org.W3c.Dom.IDocumentInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")]
public Org.W3c.Dom.INode? AdoptNode(Org.W3c.Dom.INode? source);

[<Android.Runtime.Register("adoptNode", "(Lorg/w3c/dom/Node;)Lorg/w3c/dom/Node;", "GetAdoptNode_Lorg_w3c_dom_Node_Handler:Org.W3c.Dom.IDocumentInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")>]
abstract member AdoptNode : Org.W3c.Dom.INode -> Org.W3c.Dom.INode

Parameter

source: INode

Der Knoten, der in dieses Dokument verschoben werden soll.

Gibt zurück

INode

Der angenommene Knoten oder null wenn dieser Vorgang fehlschlägt, z. B. wenn der Quellknoten aus einer anderen Implementierung stammt.

Attribute: RegisterAttribute

Ausnahmen

DOMException

NOT_SUPPORTED_ERR: Wird ausgelöst, wenn der Quellknoten vom Typ DOCUMENT, DOCUMENT_TYPE.
NO_MODIFICATION_ALLOWED_ERR: Wird ausgelöst, wenn der Quellknoten schreibgeschützt ist.

Hinweise

Versucht, einen Knoten von einem anderen Dokument in dieses Dokument zu übernehmen. Wenn diese Unterstützung unterstützt wird, ändert sie den ownerDocument Quellknoten, dessen untergeordnete Elemente sowie die angefügten Attributknoten, falls vorhanden. Wenn der Quellknoten über ein übergeordnetes Element verfügt, wird er zuerst aus der untergeordneten Liste des übergeordneten Elements entfernt. Dadurch kann eine Unterstruktur effektiv von einem Dokument in ein anderes verschoben werden (im Gegensatz dazu importNode() , dass eine Kopie des Quellknotens erstellt wird, anstatt sie zu verschieben). Wenn ein Fehler auftritt, sollten Anwendungen stattdessen verwendet werden Document.importNode() . Beachten Sie, dass, wenn der angenommene Knoten bereits Teil dieses Dokuments ist (d. h. das Quell- und Zieldokument identisch ist), diese Methode weiterhin die Auswirkung hat, den Quellknoten aus der untergeordneten Liste des übergeordneten Elements zu entfernen, falls vorhanden. In der folgenden Liste werden die Besonderheiten für jeden Knotentyp beschrieben. <dl>dt ATTRIBUTE_NODE/dt<>dd>Das ownerElement Attribut ist auf festgelegtnull, und die specified Kennzeichnung wird auf die angenommene Attrfestgelegttrue.<>< Die Nachfolger der Quelle Attr werden rekursiv übernommen.</dd><dt>DOCUMENT_FRAGMENT_NODE</dt><dd>Die Nachfolger des Quellknotens werden rekursiv übernommen.</dd><dt>DOCUMENT_NODE</dt><dd>Document Knoten können nicht übernommen werden.</dd dt DOCUMENT_TYPE_NODE/dtd-KnotenDocumentType<>> können nicht übernommen werden.<<>></dd><dt>ELEMENT_NODE</dt<>dd><em>Specified</em> attributknoten des Quellelements werden übernommen. Standardattribute werden verworfen. Wenn das Dokument in die Definition von Standardattributen für diesen Elementnamen übernommen wird, werden diese jedoch zugewiesen. Die Nachfolger des Quellelements werden rekursiv übernommen.</dd dt ENTITY_NODE/dtd-Knoten>><Entity können nicht übernommen werden.<<>></dd><dt>ENTITY_REFERENCE_NODE</dt<>dd>Nur der EntityReference Knoten selbst wird übernommen, die Nachfolger werden verworfen, da die Quell- und Zieldokumente die Entität möglicherweise anders definiert haben. Wenn das dokument, in das importiert wird, eine Definition für diesen Entitätsnamen bereitstellt, wird dessen Wert zugewiesen.</dd><dt>NOTATION_NODE</dt><dd>Notation Knoten können nicht übernommen werden.</dd><dt>PROCESSING_INSTRUCTION_NODE, TEXT_NODE, CDATA_SECTION_NODE, COMMENT_NODE</dt><dd>Diese Knoten können alle übernommen werden. Keine Einzelheiten.</dd></dl>

<b>Hinweis:</b> Da keine neuen Knoten im Gegensatz zur Document.importNode() Methode erstellt werden, löst INVALID_CHARACTER_ERR diese Methode keine Ausnahme aus, und Anwendungen sollten die Document.normalizeDocument() Methode verwenden, um zu überprüfen, ob ein importierter Name kein XML-Name gemäß der verwendeten XML-Version ist.

In DOM-Ebene 3 hinzugefügt.

Java Dokumentation für org.w3c.dom.Document.adoptNode(org.w3c.dom.Node).

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.

Gilt für: