IDocument.ImportNode(INode, Boolean) Methode

Definition

Importiert einen Knoten aus einem anderen Dokument in dieses Dokument, ohne den Quellknoten aus dem Originaldokument zu ändern oder zu entfernen; Diese Methode erstellt eine neue Kopie des Quellknotens.

[Android.Runtime.Register("importNode", "(Lorg/w3c/dom/Node;Z)Lorg/w3c/dom/Node;", "GetImportNode_Lorg_w3c_dom_Node_ZHandler:Org.W3c.Dom.IDocumentInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")]
public Org.W3c.Dom.INode? ImportNode(Org.W3c.Dom.INode? importedNode, bool deep);
[<Android.Runtime.Register("importNode", "(Lorg/w3c/dom/Node;Z)Lorg/w3c/dom/Node;", "GetImportNode_Lorg_w3c_dom_Node_ZHandler:Org.W3c.Dom.IDocumentInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")>]
abstract member ImportNode : Org.W3c.Dom.INode * bool -> Org.W3c.Dom.INode

Parameter

importedNode
INode

Der zu importierende Knoten.

deep
Boolean

Wenn true, rekursiv die Unterstruktur unter dem angegebenen Knoten importieren; wenn false, importieren Sie nur den Knoten selbst, wie oben erläutert. Dies hat keine Auswirkungen auf Knoten, die keine untergeordneten Elemente haben können, und auf Attrund EntityReference auf Knoten.

Gibt zurück

Der importierte Knoten, der zu diesem DocumentKnoten gehört.

Attribute

Ausnahmen

NOT_SUPPORTED_ERR: Wird ausgelöst, wenn der Typ des zu importierenden Knotens nicht unterstützt wird.
INVALID_CHARACTER_ERR: Wird ausgelöst, wenn einer der importierten Namen kein XML-Name gemäß der im Document.xmlVersion Attribut angegebenen XML-Version ist. Dies kann passieren, wenn sie beispielsweise ein XML 1.1 []-Element in ein XML 1.0-Dokument importieren.

Hinweise

Importiert einen Knoten aus einem anderen Dokument in dieses Dokument, ohne den Quellknoten aus dem Originaldokument zu ändern oder zu entfernen; Diese Methode erstellt eine neue Kopie des Quellknotens. Der zurückgegebene Knoten hat kein übergeordnetes Element; (parentNode ist null). < >Br Für alle Knoten erstellt der Import eines Knotens ein Knotenobjekt, das dem importierten Dokument gehört, mit Attributwerten, die mit den Quellknoten nodeName und den nodeTypeAttributen im Zusammenhang mit Namespaces (prefix, localNameund namespaceURI) identisch sind. Wie im cloneNode Vorgang wird der Quellknoten nicht geändert. Benutzerdaten, die dem importierten Knoten zugeordnet sind, werden nicht übertragen. Wenn UserDataHandlers jedoch zusammen mit den zugehörigen Daten angegeben wurde, werden diese Handler mit den entsprechenden Parametern aufgerufen, bevor diese Methode zurückgegeben wird. <Br>Zusätzliche Informationen werden entsprechend dem nodeTypeVersuch kopiert, das Verhalten zu spiegeln, das erwartet wird, wenn ein Fragment von XML- oder HTML-Quelle aus einem Dokument in ein anderes kopiert wurde, wobei erkannt wird, dass die beiden Dokumente möglicherweise unterschiedliche DTDs im XML-Fall haben. In der folgenden Liste werden die Besonderheiten für jeden Knotentyp beschrieben. <dl>dt ATTRIBUTE_NODE/dt<>dd>Das ownerElement Attribut ist auf das Attribut festgelegt null und für specified das generierte AttrAttribut festgelegttrue.<>< Die Nachfolger der Quelle Attr werden rekursiv importiert und die resultierenden Knoten neu zusammengesetzt, um die entsprechende Unterstruktur zu bilden. Beachten Sie, dass der deep Parameter keine Auswirkungen auf Attr Knoten hat; sie tragen ihre untergeordneten Elemente immer mit ihnen, wenn sie importiert werden.</dd dt DOCUMENT_FRAGMENT_NODE/dt<>dd>If the deep option was set to true, the descendants of the source DocumentFragment are rekursive imported and the result nodes reassembled under the imported DocumentFragment to form the corresponding subtree.<>>< Andernfalls generiert dies einfach eine leere DocumentFragment.</dd dt DOCUMENT_NODE/dtd-KnotenDocument<>> können nicht importiert werden.<<>></dd dt DOCUMENT_TYPE_NODE/dtd-KnotenDocumentType<>> können nicht importiert werden.<<>></dd dt ELEMENT_NODE/dt<>dd><em>Specified</em-Attributknoten> des Quellelements werden importiert, und die generierten Knoten werden an die generierten ElementAttr Knoten angefügt.<>>< Standardattribute werden <nicht></em> kopiert. Wenn das dokument importiert wird, werden jedoch Standardattribute für diesen Elementnamen definiert. Wenn der importNodedeep Parameter auf true"Festgelegt" festgelegt wurde, werden die Nachfolger des Quellelements rekursiv importiert und die resultierenden Knoten neu zusammengesetzt, um die entsprechende Unterstruktur zu bilden.</dd dt ENTITY_NODE/dt><dd>Entity knoten können importiert werden, in der aktuellen Version des DOM ist dies DocumentType jedoch schreibgeschützt.<>>< Die Möglichkeit, diese importierten Knoten zu einem DocumentType hinzuzufügen, wird zusätzlich zu einer zukünftigen Version des DOM berücksichtigt. Beim Import werden die publicIdAttribute systemIdund Attribute notationName kopiert. Wenn ein deep Import angefordert wird, werden die Nachfolger der Quelle Entity rekursiv importiert und die resultierenden Knoten neu zusammengesetzt, um die entsprechende Unterstruktur zu bilden.</dd dt ENTITY_REFERENCE_NODE/dt<>dd>Nur das EntityReference Selbst wird kopiert, auch wenn ein deep Import angefordert wird, 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 importiert werden, in der aktuellen Version des DOM ist dies DocumentType jedoch schreibgeschützt.<>>< Die Möglichkeit, diese importierten Knoten zu einem DocumentType hinzuzufügen, wird zusätzlich zu einer zukünftigen Version des DOM berücksichtigt. Beim Import werden die publicId Attribute kopiert systemId . Beachten Sie, dass der deep Parameter keine Auswirkungen auf diesen Knotentyp hat, da sie keine untergeordneten Elemente haben können.</dd><dt> PROCESSING_INSTRUCTION_NODE</dt<>dd>Der importierte Knoten kopiert seine target und data Werte aus denen des Quellknotens. Beachten Sie, dass der deep Parameter keine Auswirkungen auf diesen Knotentyp hat, da sie keine untergeordneten Elemente haben können.</dd><dt>TEXT_NODE, CDATA_SECTION_NODE, COMMENT_NODE</dt><dd>Diese drei Knotentypen, die von CharacterData der Kopie ihrer data Und length Attribute von denen des Quellknotens erben. Beachten Sie, dass der deep Parameter keine Auswirkungen auf diese Knotentypen hat, da sie keine untergeordneten Elemente haben können.</dd></dl>

In DOM-Ebene 2 hinzugefügt.

Java Dokumentation für org.w3c.dom.Document.importNode(org.w3c.dom.Node, boolean).

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: