IDocument.ImportNode(INode, Boolean) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Importa un nodo de otro documento a este documento, sin modificar ni quitar el nodo de origen del documento original; este método crea una nueva copia del nodo de origen.
[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
Parámetros
- importedNode
- INode
Nodo que se va a importar.
- deep
- Boolean
Si truees , importe de forma recursiva el subárbol bajo el nodo especificado; si falsees , importe solo el propio nodo, como se explicó anteriormente. Esto no tiene ningún efecto en los nodos que no pueden tener elementos secundarios y en Attrlos nodos , y EntityReference .
Devoluciones
Nodo importado que pertenece a este Document.
- Atributos
Excepciones
NOT_SUPPORTED_ERR: se genera si no se admite el tipo de nodo que se está importando.
INVALID_CHARACTER_ERR: se genera si uno de los nombres importados no es un nombre XML según la versión XML en uso especificada en el Document.xmlVersion atributo . Esto puede ocurrir al importar un elemento XML 1.1 [] en un documento XML 1.0, por ejemplo.
Comentarios
Importa un nodo de otro documento a este documento, sin modificar ni quitar el nodo de origen del documento original; este método crea una nueva copia del nodo de origen. El nodo devuelto no tiene ningún elemento primario; (parentNode es null).
<br>Para todos los nodos, la importación de un nodo crea un objeto de nodo propiedad del documento de importación, con valores de atributo idénticos a los del nodo de nodeName origen y nodeType, además de los atributos relacionados con los espacios de nombres (prefix, localNamey namespaceURI). Como en la cloneNode operación, el nodo de origen no se modifica. Los datos de usuario asociados al nodo importado no se transfieren. Sin embargo, si se ha especificado alguno UserDataHandlers junto con los datos asociados, se llamará a estos controladores con los parámetros adecuados antes de que este método devuelva.
<br>Se copia información adicional según corresponda a nodeType, intentando reflejar el comportamiento esperado si se copió un fragmento de código FUENTE XML o HTML de un documento a otro, reconociendo que los dos documentos pueden tener dtD diferentes en el caso XML. 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 en el generadonull.specifiedtrueAttr Los descendientes del Attr origen se importan de forma recursiva y los nodos resultantes se vuelven a ensamblar para formar el subárbol correspondiente. Tenga en cuenta que el deep parámetro no tiene ningún efecto en Attr los nodos; siempre llevan sus elementos secundarios con ellos cuando se importan.</dd dt DOCUMENT_FRAGMENT_NODE/dt><dd>Si la < opción se estableció >en , los descendientes del < origen se importan de forma recursiva y los nodos resultantes se vuelven a ensamblar en el importado > para formar el subárbol correspondiente.deeptrueDocumentFragmentDocumentFragment De lo contrario, esto simplemente genera un vacíoDocumentFragment.<No se pueden importar nodos /dd dt DOCUMENT_NODE/dt><dd>.<><>Document<No se pueden importar nodos /dd dt DOCUMENT_TYPE_NODE/dt><dd>.<><>DocumentType<Los nodos de atributo /dd dt ELEMENT_NODE/dtd><>em<Specified>/em< del elemento de origen se importan y los nodos generados >< se adjuntan al objeto generado.><>AttrElement Los atributos predeterminados se copian <em>not</em> , aunque si el documento que se importa define los atributos predeterminados para este nombre de elemento, se asignan. Si el importNodedeep parámetro se estableció trueen , los descendientes del elemento de origen se importan de forma recursiva y los nodos resultantes se vuelven a ensamblar para formar el subárbol correspondiente.<Se pueden importar nodos /dd dt ENTITY_NODE/dt><dd><; sin embargo, en la versión actual del DOM se > lee.<>EntityDocumentType La capacidad de agregar estos nodos importados a un DocumentType se considerará además de una versión futura del DOM. En la importación, se copian los publicIdatributos , systemIdy notationName . Si se solicita una deep importación, los descendientes del Entity origen se importan de forma recursiva y los nodos resultantes se vuelven a ensamblar para formar el subárbol correspondiente.</dd dt ENTITY_REFERENCE_NODE/dt><dd>Solo se copia el < propio , aunque se solicite una > importación, ya que es posible que los documentos de origen y destino hayan definido la entidad de forma diferente.<>EntityReferencedeep Si el documento que se importa en proporciona una definición para este nombre de entidad, se asigna su valor.<Se pueden importar nodos /dd dt NOTATION_NODE/dt><dd><; sin embargo, en la versión actual del DOM se > lee.<>NotationDocumentType La capacidad de agregar estos nodos importados a un DocumentType se considerará además de una versión futura del DOM. Al importar, se copian los publicId atributos y systemId . Tenga en cuenta que el deep parámetro no tiene ningún efecto en este tipo de nodos, ya que no pueden tener elementos secundarios.</dd><dt> PROCESSING_INSTRUCTION_NODE</dt><dd>El nodo importado copia sus target valores y data de los del nodo de origen. Tenga en cuenta que el deep parámetro no tiene ningún efecto en este tipo de nodos, ya que no pueden tener elementos secundarios.</dd><dt>TEXT_NODE, CDATA_SECTION_NODE, COMMENT_NODE</dt><dd>Estos tres tipos de nodos heredan de CharacterData copiar sus data atributos y length de los del nodo de origen. Tenga en cuenta que el deep parámetro no tiene ningún efecto en estos tipos de nodos, ya que no pueden tener elementos secundarios.</dd></dl>
Agregado en dom nivel 2.
Java documentación para org.w3c.dom.Document.importNode(org.w3c.dom.Node, boolean).
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.