IDocument.AdoptNode(INode) メソッド

定義

名前空間:

Org.W3c.Dom

アセンブリ:

Mono.Android.dll

別のドキュメントからこのドキュメントへのノードの導入を試みます。

[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

パラメーター

source

INode

このドキュメントに移動するノード。

戻り値

INode

採用されたノード、または null ソース ノードが別の実装から取得された場合など、この操作が失敗した場合。

属性

RegisterAttribute

例外

DOMException

NOT_SUPPORTED_ERR: ソース ノードの型 DOCUMENTが の DOCUMENT_TYPE場合に発生します。
NO_MODIFICATION_ALLOWED_ERR: ソース ノードが読み取り時に発生します。

注釈

別のドキュメントからこのドキュメントへのノードの導入を試みます。 サポートされている場合は、ソース ノード、その子、およびアタッチされた属性ノード (存在する場合) が変更 ownerDocument されます。 ソース ノードに親がある場合は、最初にその親の子リストから削除されます。 これにより、実質的にサブツリーを 1 つのドキュメントから別のドキュメントに移動できます (移動する代わりにソース ノードのコピーを作成する場合とは異なります importNode() )。 失敗した場合は、代わりに アプリケーションで を使用 Document.importNode() する必要があります。 採用されたノードがこのドキュメントに既に含まれている場合 (つまり、ソースとターゲットのドキュメントが同じである場合)、このメソッドは親の子リストからソース ノードを削除する効果があります (存在する場合)。 次の一覧では、ノードの種類ごとの詳細について説明します。 <dl>dt ATTRIBUTE_NODE/dt><dd ownerElement>属性は にnull設定され、specifiedフラグは、採用されている Attrで にtrue設定されます。<>< ソース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><p ><b>注:</b> メソッドとは異なりDocument.importNode()、新しいノードは作成されないため、このメソッドは例外をINVALID_CHARACTER_ERR発生させず、インポートされた名前が使用中の XML バージョンに従って XML 名でない場合は、アプリケーションで メソッドを使用Document.normalizeDocument()してチェックする必要があります。

DOM レベル 3 で追加されました。

の Java ドキュメント org.w3c.dom.Document.adoptNode(org.w3c.dom.Node)。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。