IDocument.ImportNode(INode, Boolean) Método

Definição

Namespace:: Org.W3c.Dom

Assembly:: Mono.Android.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Importa um nó de outro documento para este documento, sem alterar ou remover o nó de origem do documento original; esse método cria uma nova cópia do nó de origem.

[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

O nó a ser importado.

deep: Boolean

Se true, importar recursivamente a subárvore no nó especificado; se false, importar apenas o nó em si, conforme explicado acima. Isso não tem efeito em nós que não podem ter filhos, nem em Attrnós.EntityReference

Retornos

INode

O nó importado que pertence a este Document.

Atributos: RegisterAttribute

Exceções

DOMException

NOT_SUPPORTED_ERR: Gerado se não houver suporte para o tipo de nó que está sendo importado.
INVALID_CHARACTER_ERR: gerado se um dos nomes importados não for um nome XML de acordo com a versão XML em uso especificada no Document.xmlVersion atributo. Isso pode acontecer ao importar um elemento XML 1.1 [] para um documento XML 1.0, por exemplo.

Comentários

Importa um nó de outro documento para este documento, sem alterar ou remover o nó de origem do documento original; esse método cria uma nova cópia do nó de origem. O nó retornado não tem pai; (parentNode é null). <br>Para todos os nós, a importação de um nó cria um objeto de nó pertencente ao documento de importação, com valores de atributo idênticos aos do nó de nodeName origem e, nodeTypemais os atributos relacionados aos namespaces (prefixelocalNamenamespaceURI). Como na cloneNode operação, o nó de origem não é alterado. Os dados do usuário associados ao nó importado não são carregados. No entanto, se algum UserDataHandlers tiver sido especificado junto com os dados associados, esses manipuladores serão chamados com os parâmetros apropriados antes que esse método retorne. <br>Informações adicionais são copiadas conforme apropriado para o nodeType, tentando espelhar o comportamento esperado se um fragmento de origem XML ou HTML foi copiado de um documento para outro, reconhecendo que os dois documentos podem ter DTDs diferentes no caso XML. 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 é definido true como no gerado Attr. Os descendentes da origem Attr são importados recursivamente e os nós resultantes são remontados para formar a subárvore correspondente. Observe que o deep parâmetro não tem efeito sobre Attr nós; eles sempre carregam seus filhos com eles quando importados.</dd><dt>DOCUMENT_FRAGMENT_NODE</dt><dd>Se a opção deep foi definida como true, os descendentes da origem DocumentFragment são importados recursivamente e os nós resultantes remontados sob o importado DocumentFragment para formar a subárvore correspondente. Caso contrário, isso simplesmente gerará um vazioDocumentFragment.</dd><dt>DOCUMENT_NODE</dt><dd>Document nós não podem ser importados.</dd><dt>DOCUMENT_TYPE_NODE</dt><dd>DocumentType nós não podem ser importados.</dd><dt>ELEMENT_NODE</dt><dd><em>Nós de atributo especificados</em> do elemento de origem são importados e os nós gerados Attr são anexados ao geradoElement. Os atributos padrão não< são ><copiados,> embora se o documento que está sendo importado para definir atributos padrão para esse nome de elemento, eles serão atribuídos. Se o importNodedeep parâmetro foi definido como true, os descendentes do elemento de origem são importados recursivamente e os nós resultantes remontados para formar a subárvore correspondente.</dd><dt>ENTITY_NODE</dt><dd>Entity nós podem ser importados, no entanto, na versão atual do DOM, é DocumentType somente leitura. A capacidade de adicionar esses nós importados a um DocumentType será considerada para além de uma versão futura do DOM. Na importação, os publicIdatributos , e systemId , notationNamesão copiados. Se uma deep importação for solicitada, os descendentes da origem Entity serão importados recursivamente e os nós resultantes serão remontados para formar a subárvore correspondente.</dd><dt> ENTITY_REFERENCE_NODE</dt><dd>Somente o EntityReference próprio é copiado, mesmo se uma deep importação for solicitada, já que 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 podem ser importados, no entanto, na versão atual do DOM, é DocumentType somente leitura. A capacidade de adicionar esses nós importados a um DocumentType será considerada para além de uma versão futura do DOM. Na importação, os atributos e os publicId atributos systemId são copiados. Observe que o deep parâmetro não tem efeito sobre esse tipo de nós, pois eles não podem ter filhos.</dd><dt> PROCESSING_INSTRUCTION_NODE</dt><dd>O nó importado copia seus target valores e data valores daqueles do nó de origem. Observe que o deep parâmetro não tem efeito sobre esse tipo de nós, pois eles não podem ter filhos.</dd><dt>TEXT_NODE, CDATA_SECTION_NODE, COMMENT_NODE</dt><dd>Esses três tipos de nós herdados da CharacterData cópia de seus data atributos e length dos do nó de origem. Observe que o deep parâmetro não tem efeito sobre esses tipos de nós, pois eles não podem ter filhos.</dd></dl>

Adicionado no Nível 2 do DOM.

Java documentação para org.w3c.dom.Document.importNode(org.w3c.dom.Node, boolean).

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.

Aplica-se a