IDocument.AdoptNode(INode) Método

Definição

Namespace:

Org.W3c.Dom

Assembly:

Mono.Android.dll

Tenta adotar um nó de outro documento para este documento.

[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

Parâmetros

source

INode

O nó a ser movido para este documento.

Retornos

INode

O nó adotado ou null se essa operação falhar, como quando o nó de origem vem de uma implementação diferente.

Atributos

RegisterAttribute

Exceções

DOMException

NOT_SUPPORTED_ERR: Gerado se o nó de origem for do tipo DOCUMENT, DOCUMENT_TYPE.
NO_MODIFICATION_ALLOWED_ERR: Gerado quando o nó de origem é somente leitura.

Comentários

Tenta adotar um nó de outro documento para este documento. Se houver suporte, ele alterará o nó de origem ownerDocument , seus filhos, bem como os nós de atributo anexados, se houver algum. Se o nó de origem tiver um pai, ele será removido pela primeira vez da lista filho de seu pai. Isso efetivamente permite mover uma subárvore de um documento para outro (ao contrário importNode() do que cria uma cópia do nó de origem em vez de movê-la). Quando falha, os aplicativos devem usar Document.importNode() em vez disso. Observe que, se o nó adotado já fizer parte deste documento (ou seja, o documento de origem e de destino é o mesmo), esse método ainda terá o efeito de remover o nó de origem da lista filho de seu pai, se houver. A lista a seguir descreve as especificidades para cada tipo de nó. <dl><dt>ATTRIBUTE_NODE</dt><dd>O ownerElement atributo é definido null como e o specified sinalizador está definido true como no adotado Attr. Os descendentes da origem Attr são recursivamente adotados.</dd><dt>DOCUMENT_FRAGMENT_NODE</dt><dd>Os descendentes do nó de origem são recursivamente adotados.</dd><dt>DOCUMENT_NODE</dt><dd>Document nós não podem ser adotados.</dd><dt>DOCUMENT_TYPE_NODE</dt><dd>DocumentType nós não podem ser adotados.</dd><dt>ELEMENT_NODE</dt><dd><em>nós de atributo Especificado</em> do elemento de origem são adotados. Os atributos padrão são descartados, embora se o documento que está sendo adotado definir atributos padrão para esse nome de elemento, eles serão atribuídos. Os descendentes do elemento de origem são recursivamente adotados.</dd><dt>ENTITY_NODE</dt><dd>Entity nós não podem ser adotados.</dd><dt>ENTITY_REFERENCE_NODE</dt><dd>Somente o EntityReference nó em si é adotado, os descendentes são descartados, pois os documentos de origem e de destino podem ter definido a entidade de forma diferente. Se o documento que está sendo importado para fornecer uma definição para esse nome de entidade, seu valor será atribuído.</dd><dt>NOTATION_NODE</dt><dd>Notation nós não podem ser adotados.</dd><dt>PROCESSING_INSTRUCTION_NODE, TEXT_NODE, CDATA_SECTION_NODE, COMMENT_NODE</dt><dd>Todos esses nós podem ser adotados. Não há detalhes.</dd></dl>

<b>Observação:</b> Como ele não cria novos nós diferentemente do Document.importNode() método, esse método não gera uma INVALID_CHARACTER_ERR exceção e os aplicativos devem usar o Document.normalizeDocument() método para verificar se um nome importado não é um nome XML de acordo com a versão XML em uso.

Adicionado no Nível 3 do DOM.

Java documentação para org.w3c.dom.Document.adoptNode(org.w3c.dom.Node).

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Android Open Source Project e usadas de acordo com os termos descritos na Licença de Atribuição Creative Commons 2.5.