IDocument.AdoptNode(INode) 方法

[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

參數

傳回

採用節點，或 null 當此操作失敗時，例如來源節點來自不同實作。

屬性

RegisterAttribute

例外狀況

備註

嘗試將其他文件中的節點套用到此文件。 若支援，則會改變來源節點、其子節點，以及若有附加屬性節點的 。ownerDocument 如果來源節點有父節點，首先會從其父節點的子節點清單中移除。 這實際上允許將子樹從一個文件移到另一個文件（不同 importNode() 於後者是建立來源節點的複製品而非移動它）。 當它失敗時，應用程式應該用 Document.importNode() 它來代替。 請注意，若採用節點已是該文件的一部分（即來源與目標文件相同），此方法仍會將來源節點從其父節點的子清單中移除（若有的話）。 以下列表說明了每種節點類型的細節。 <dl>dt ATTRIBUTE_NODE/dt<>dd <>屬性設<>為 ，旗標設為 ，ownerElement採用 。nullspecifiedtrueAttr 源的後代Attr會被遞迴採用。</dd><dt>DOCUMENT_FRAGMENT_NODE</dt><dd>來源節點的後代會遞迴採用。</dd><dt>DOCUMENT_NODE</dt><DD>Document 節點無法被採用。</dd><dt>DOCUMENT_TYPE_NODE</dt><DD>DocumentType 節點無法被採用。</dd>dt ELEMENT_NODE/dt<>dd<em>採用來源元素的指定</em><屬性節點。><> 預設屬性會被捨棄，但如果被採用的文件定義了該元素名稱的預設屬性，則會被指派這些屬性。 來源元素的後代會遞迴採用。</dd><dt>ENTITY_NODE</dt><DD>Entity 節點無法被採用。</dd><dt>ENTITY_REFERENCE_NODE</dt><dd>僅 EntityReference 採用節點本身，後代則被捨棄，因為來源文件與目的文件可能對實體的定義不同。 如果被匯入的文件提供了該實體名稱的定義，則會賦予其值。</dd><dt>NOTATION_NODE</dt><DD>Notation 節點無法被採用。</dd><dt PROCESSING_INSTRUCTION_NODE>、TEXT_NODE、CDATA_SECTION_NODE、COMMENT_NODE</dt><dd>這些節點都可以被採用。 沒有具體細節。</dd></dl>

<b>注意：</b> 由於此方法不像 Old Document.importNode() Method 那樣建立新節點，因此不會產生 INVALID_CHARACTER_ERR 例外，應用程式應使用此 Document.normalizeDocument() 方法檢查匯入名稱是否依照所用 XML 版本為 XML 名稱。

新增於DOM第三級。

的 org.w3c.dom.Document.adoptNode(org.w3c.dom.Node)Java 檔。

此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。