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

매개 변수

source
INode

이 문서로 이동할 노드입니다.

반품

채택된 노드 또는 null 원본 노드가 다른 구현에서 오는 경우와 같이 이 작업이 실패하는 경우입니다.

특성

예외

NOT_SUPPORTED_ERR: 원본 노드가 형식DOCUMENTDOCUMENT_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 채택되고 원본 및 대상 문서에서 엔터티를 다르게 정의했을 수 있으므로 하위 항목은 삭제됩니다. 가져오는 문서가 이 엔터티 이름에 대한 정의를 제공하는 경우 해당 값이 할당됩니다.</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> 메서드와 달리 Document.importNode() 새 노드를 만들지 않으므로 이 메서드는 예외를 INVALID_CHARACTER_ERR 발생시키지 않으며, 애플리케이션은 이 메서드를 사용하여 Document.normalizeDocument() 가져온 이름이 사용 중인 XML 버전에 따라 XML 이름이 아닌지 확인해야 합니다.

DOM 수준 3에 추가되었습니다.

에 대한 org.w3c.dom.Document.adoptNode(org.w3c.dom.Node)Java 설명서

이 페이지의 일부는 만들고 공유한 작업을 기반으로 하며 에 설명된 조건에 따라 사용됩니다.

적용 대상