語言

IDocument.ImportNode(INode, Boolean) 方法

定義

命名空間:
Org.W3c.Dom
組件:
Mono.Android.dll

將另一個文件的節點匯入至此文件，且不更改或移除原始文件中的來源節點;此方法會建立一個新的來源節點副本。

[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

參數

importedNode
INode

要匯入的節點。

deep
Boolean

若 true，則遞迴匯入指定節點下的子樹;若 false，則僅匯入節點本身，如上所述。 這對無法有子節點 Attr的節點、以及節點 、 EntityReference 和 節點都沒有影響。

傳回

INode

屬於此 Document的匯入節點。

屬性
RegisterAttribute

例外狀況

DOMException

NOT_SUPPORTED_ERR：若匯入的節點類型不支援，則提出。
INVALID_CHARACTER_ERR：若匯入名稱中某個名稱並非屬性中指定的 Document.xmlVersion XML 版本所指定的 XML 名稱，則會被提出。 例如，當將 XML 1.1 [] 元素匯入 XML 1.0 文件時，可能會發生這種情況。

備註

將另一個文件的節點匯入至此文件，且不更改或移除原始文件中的來源節點;此方法會建立一個新的來源節點副本。 回傳節點沒有父節點;（parentNode 是 null）。 <br>對於所有節點，匯入節點會建立一個由匯入文件擁有的節點物件，其屬性值與來源節點 nodeName 的 和 nodeType相同，以及與命名空間相關的屬性（prefix， localName， 和 namespaceURI）。 與操作 cloneNode 相同，來源節點未被更改。 與匯入節點相關的使用者資料不會被帶入。 然而，若 UserDataHandlers 有相關資料及相關資料指定，這些處理器會在回傳前以適當參數被呼叫。 <br>會根據適當方式複製額外 nodeType資訊，試圖鏡像出若將 XML 或 HTML 原始碼片段從一份文件複製到另一份文件時所預期的行為，並因應 XML 情況中兩份文件可能擁有不同的 DTD。 以下列表說明了每種節點類型的細節。 <dl>dt ATTRIBUTE_NODE/dt<>dd<> 屬性設為 ，<>ownerElement且 在產生null的 中 標記為 。specifiedtrueAttr 來源的後代 Attr 會遞迴匯入，並重新組合產生的節點以形成對應的子樹。 請注意，這個deep參數對Attr節點沒有影響;它們在匯入時總是會攜帶子節點。</dd>dt DOCUMENT_FRAGMENT_NODE/dt<>dd<若>選項設為 <，則會遞迴匯入來源>的後代，並將所得節點在匯deep入後重新組合形成對應的子樹。trueDocumentFragmentDocumentFragment 否則，這只會產生一個空的 DocumentFragment。</dd><dt>DOCUMENT_NODE</dt><DD>Document 節點無法匯入。</dd><dt>DOCUMENT_TYPE_NODE</dt><DD>DocumentType 節點無法匯入。</dd>dt ELEMENT_NODE/dt<>dd<em>來源元素的指定</em><屬性節點會被匯入，並將產生>的節點附加到生成<的 。>AttrElement 預設屬性為 <em>not</em> copied，但如果被匯入的文件定義了該元素名稱的預設屬性，則會被指派這些屬性。 若importNodedeep參數設為 true，則來源元素的後代會遞迴匯入，並重新組合產生的節點形成對應的子樹。</dd>dt ENTITY_NODE/dt<>的 dd<> 節點可以匯入，但在目前 DOM 版本中，該<節點為唯讀。>EntityDocumentType 未來 DOM 版本中將考慮將這些匯入節點DocumentType加入 。匯入時，publicIdsystemId、、 和 notationName 屬性會被複製。 若deep請求匯入，來源的後代Entity會被遞迴匯入，並將所得節點重新組合成對應的子樹。</dd>dt ENTITY_REFERENCE_NODE/dt<>dd<即使請求匯入，也只會複製>實體<本身，因為來源文件與目的文件可能對實體的定義不同。>EntityReferencedeep 如果被匯入的文件提供了該實體名稱的定義，則會賦予其值。</dd>dt NOTATION_NODE/dt<>dd<> 節點可以匯入，但在目前 DOM 版本中，節點<為唯讀。>NotationDocumentType 未來 DOM 版本中將考慮將這些匯入節點DocumentType加入 。匯入時，publicIdsystemId屬性會被複製。 請注意，該deep參數對此類節點無影響，因為它們無法有子節點。</dd>dt PROCESSING_INSTRUCTION_NODE/dt<>dd<匯入節點會從來源節點的值複製>其 和 < 值。>targetdata請注意，該deep參數對此類節點無影響，因為它們無法有子節點。</dd><dt>TEXT_NODE、CDATA_SECTION_NODE、COMMENT_NODE</dt><dd>這三種從CharacterData來源節點複製其data屬性的length節點。請注意，該deep參數對這類節點沒有影響，因為它們無法有子節點。</dd></dl>

新增於DOM第二級。

的 org.w3c.dom.Document.importNode(org.w3c.dom.Node, boolean)Java 檔。

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

適用於