IDocument.AdoptNode(INode) Método

[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

Devoluciones

El nodo adoptado, o null si se produce un error en esta operación, como cuando el nodo de origen procede de una implementación diferente.

Atributos

RegisterAttribute

Excepciones

Comentarios

Intenta adoptar un nodo de otro documento a este documento. Si se admite, cambia el ownerDocument del nodo de origen, sus elementos secundarios, así como los nodos de atributo adjuntos si hay alguno. Si el nodo de origen tiene un elemento primario, primero se quita de la lista secundaria de su elemento primario. Esto permite mover eficazmente un subárbol de un documento a otro (a diferencia importNode() de lo que crea una copia del nodo de origen en lugar de moverlo). Cuando se produce un error, las aplicaciones deben usarse Document.importNode() en su lugar. Tenga en cuenta que si el nodo adoptado ya forma parte de este documento (es decir, el documento de origen y de destino es el mismo), este método sigue teniendo el efecto de quitar el nodo de origen de la lista secundaria de su elemento primario, si existe. En la lista siguiente se describen los detalles de cada tipo de nodo. <dl>dt ATTRIBUTE_NODE/dt<>dd<El > atributo se establece < en y la > marca se establece ownerElement en en el objeto adoptadonull.specifiedtrueAttr Los descendientes del Attr origen se adoptan de forma recursiva.</dd><dt>DOCUMENT_FRAGMENT_NODE</dt><dd>Los descendientes del nodo de origen se adoptan recursivamente.<No se pueden adoptar nodos /dd dt DOCUMENT_NODE/dt><dd>.<><>Document<No se pueden adoptar nodos /dd dt DOCUMENT_TYPE_NODE/dt><dd>.<><>DocumentType<Se adoptan los nodos de atributo /dd dt ELEMENT_NODE/dt><dd>em<Specified>/em< del elemento de origen.><><> Los atributos predeterminados se descartan, aunque si el documento que se va a adoptar define los atributos predeterminados para este nombre de elemento, se asignan. Los descendientes del elemento de origen se adoptan de forma recursiva.<No se pueden adoptar los nodos /dd dt ENTITY_NODE/dt><dd>.<><>Entity</dd><dt>ENTITY_REFERENCE_NODE</dt><dd>Solo se adopta el EntityReference propio nodo, se descartan los descendientes, ya que los documentos de origen y destino podrían haber definido la entidad de forma diferente. Si el documento que se importa en proporciona una definición para este nombre de entidad, se asigna su valor.<No se pueden adoptar nodos /dd dt NOTATION_NODE/dt><dd>.<><>Notation</dd><dt>PROCESSING_INSTRUCTION_NODE, TEXT_NODE, CDATA_SECTION_NODE, COMMENT_NODE</dt><dd>Estos nodos se pueden adoptar. No hay detalles.</dd></dl>

<b>Nota:</b> Puesto que no crea nodos nuevos a diferencia del Document.importNode() método , este método no genera una INVALID_CHARACTER_ERR excepción y las aplicaciones deben usar el Document.normalizeDocument() método para comprobar si un nombre importado no es un nombre XML según la versión XML en uso.

Agregado en DOM Level 3.

Java documentación para org.w3c.dom.Document.adoptNode(org.w3c.dom.Node).

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.