IDocument.AdoptNode(INode) メソッド

定義

名前空間:: Org.W3c.Dom

アセンブリ:: Mono.Android.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

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

[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 、その子、およびアタッチされた属性ノード (存在する場合) が変更されます。ソースノードに親がある場合、最初にその親の子リストから削除されます。これにより、サブツリーをドキュメント間で効率的に移動できます (移動ではなく、ソースノードのコピーを作成する importNode() とは異なります)。失敗した場合、アプリケーションは代わりに Document.importNode() を使用する必要があります。採用されたノードがこのドキュメントに既に含まれている場合 (つまり、ソースドキュメントとターゲットドキュメントが同じである場合)、このメソッドは親の子リストからソースノードを削除する効果があります (存在する場合)。次の一覧では、ノードの種類ごとの詳細について説明します。 <dl><dt>ATTRIBUTE_NODE</dt><dd>ownerElement属性はnullに設定され、specifiedフラグは、採用されたtrueでAttrに設定されます。ソース 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>Specified</em> 属性ノードが採用されます。既定の属性は破棄されますが、この要素名の既定の属性を定義するドキュメントに採用されている場合は、それらの属性が割り当てられます。ソース要素の子孫は再帰的に採用されます。</dd><dt>ENTITY_NODE</dt><dd>Entity ノードを使用できません</dd><dt>ENTITY_REFERENCE_NODE</dt><dd>EntityReference ノード自体が採用されている場合、ソースドキュメントとコピー先ドキュメントでエンティティの定義が異なる可能性があるため、子孫は破棄されます。インポートするドキュメントがこのエンティティ名の定義を提供する場合、その値は assigned.</dd><dt>NOTATION_NODE</dt><dd>Notation ノードを使用できません</dd><dt>PROCESSING_INSTRUCTION_NODE、TEXT_NODE、CDATA_SECTION_NODE、COMMENT_NODE</dt><dd>これらのノードはすべて採用できます。 no specifics.</dd></dl>

<b>Note:</b>Document.importNode() メソッドとは異なり、新しいノードは作成されないため、このメソッドでは INVALID_CHARACTER_ERR 例外が発生しません。アプリケーションでは、 Document.normalizeDocument() メソッドを使用して、インポートされた名前が使用中の XML バージョンに従って XML 名でないかどうかを確認する必要があります。

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

Javaドキュメント。

このページの一部は、Androidオープンソースプロジェクトによって作成および共有された作業に基づく変更であり Creative Commons 2.5属性ライセンスに記載されている条件に従って使用されます。

適用対象