IDocument.ImportNode(INode, Boolean) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
元のドキュメントのソース ノードを変更または削除せずに、別のドキュメントからこのドキュメントにノードをインポートします。このメソッドは、ソース ノードの新しいコピーを作成します。
[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 ノードには影響しません。
返品
この Documentに属するインポートされたノード。
- 属性
例外
NOT_SUPPORTED_ERR: インポートするノードの種類がサポートされていない場合に発生します。
INVALID_CHARACTER_ERR: インポートされた名前の 1 つが、 Document.xmlVersion 属性で指定された使用中の XML バージョンに従って XML 名でない場合に発生します。 これは、たとえば、XML 1.1 [] 要素を XML 1.0 ドキュメントにインポートするときに発生する可能性があります。
注釈
元のドキュメントのソース ノードを変更または削除せずに、別のドキュメントからこのドキュメントにノードをインポートします。このメソッドは、ソース ノードの新しいコピーを作成します。 返されたノードには親がありません。(parentNode は null)。
<br>すべてのノードについて、ノードをインポートすると、インポート元ノードの nodeName と nodeTypeと同じ属性値に加えて、名前空間に関連する属性 (prefix、 localName、および namespaceURI) を使用して、インポートドキュメントが所有するノード オブジェクトが作成されます。
cloneNode操作と同様に、ソース ノードは変更されません。 インポートされたノードに関連付けられているユーザー データは引き継がれません。 ただし、関連付けられたデータと共に UserDataHandlers が指定されている場合、これらのハンドラーは、このメソッドが返される前に適切なパラメーターで呼び出されます。
<br> XML または HTML ソースのフラグメントが 1 つのドキュメントから別のドキュメントにコピーされた場合に予想される動作をミラー化しようとして、2 つのドキュメントが XML ケースで異なる DTD を持つ可能性があることを認識して、追加情報が nodeTypeに適切にコピーされます。 次の一覧では、ノードの種類ごとの詳細について説明します。
<dl><dt>ATTRIBUTE_NODE</dt><dd>ownerElement属性はnullに設定され、生成されたspecifiedでtrueフラグがAttrに設定されます。 ソース Attr の子孫が再帰的にインポートされ、結果のノードが再構成されて、対応するサブツリーが形成されます。
deep パラメーターは、Attr ノードには影響しません。インポート時には常に子を持ち歩きます</dd><dt>DOCUMENT_FRAGMENT_NODE</dt><dd>deep オプションがtrueに設定されている場合、ソース DocumentFragmentの子孫が再帰的にインポートされ、結果のノードがインポートされたDocumentFragmentの下に再アセンブルされて、対応するサブツリーが形成されます。 それ以外の場合は、空の DocumentFragment.< が生成されます/dd><dt>DOCUMENT_NODE</dt><dd>Document ノードをインポートできません。</dd><dt>DOCUMENT_TYPE_NODE</dt><dd>DocumentType ノードをインポートできません。<ソース要素の /dd><dt>ELEMENT_NODE</dt><dd><em>Specified</em> 属性ノードがインポートされ、生成された Attr ノードが生成された Elementにアタッチされます。 既定の属性は<em></em>コピーされますが、インポートするドキュメントでこの要素名の既定の属性が定義されている場合は、それらが割り当てられます。
importNode
deep パラメーターが true に設定されている場合、ソース要素の子孫が再帰的にインポートされ、結果のノードが再アセンブルされて、対応するサブツリーが形成されます</dd><dt>ENTITY_NODE</dt><ddd>Entity ノードはインポートできますが、DOM の現在のリリースでは、DocumentTypeは読み取り時のみ行われます。 これらのインポートされたノードを DocumentType に追加する機能は、DOM の将来のリリースに追加する予定です。インポート時に、 publicId、 systemId、および notationName 属性がコピーされます。
deepインポートが要求されると、ソース Entityの子孫が再帰的にインポートされ、結果のノードが再アセンブルされて、対応するサブツリーが形成されます</dd><dt> ENTITY_REFERENCE_NODE</dt><dd>ソースドキュメントとコピー先ドキュメントがエンティティを異なる方法で定義している可能性があるため、EntityReferenceインポートが要求された場合でも、deep自体がコピーされます。 インポートするドキュメントがこのエンティティ名の定義を提供する場合、その値は assigned.</dd><dt>NOTATION_NODE</dt><dd>Notation ノードはインポートできますが、DOM の現在のリリースでは、 DocumentType は読み取り時のみ実行されます。 これらのインポートされたノードを DocumentType に追加する機能は、DOM の将来のリリースに追加する予定です。インポート時に、 publicId 属性と systemId 属性がコピーされます。
deep パラメーターは、子を持つことができないため、この種類のノードには影響しません。</dd><dt> PROCESSING_INSTRUCTION_NODE</dt><dd>インポートされたノードは、そのtargetとdataの値をソース ノードの値からコピーします。deep パラメーターは、子を持つことができないため、この種類のノードには影響しません。</dd><dt>TEXT_NODE、CDATA_SECTION_NODE、COMMENT_NODE</dt><dd>ソース ノードからCharacterData属性とdata属性をコピーlength継承する 3 種類のノード。deep パラメーターは、子を持つことができないため、これらの種類のノードには影響しません。</dd></dl>
DOM レベル 2 で追加されました。
このページの一部は、Androidオープンソースプロジェクトによって作成および共有された作業に基づく変更でありCreative Commons 2.5属性ライセンスに記載されている条件に従って使用されます。