Compartilhar via

Copiando nós existentes de um documento para outro

  • Artigo

O método ImportNode é o mecanismo pelo qual um nó ou uma subárvore inteira do nó são copiados de um XmlDocument para outro. O nó retornado de chamada é uma cópia do nó do documento de origem, incluindo valores de atributo, nome de nó, tipo de nó, e todos os atributos URL relacionados como o prefixo, o nome local, e namespace Uniform Resource Identifier (URI). O documento de origem não é alterado. Depois que você importou o nó, você ainda precisará adicioná-lo à árvore usando um dos métodos usados para nós de inserção.

Quando o nó é anexado ao novo documento, o novo documento possui o nó. O motivo é que cada nó, quando criado, tem um documento proprietário, mesmo se os nós são criados em partes separados do documento. Esse é um requisito do DOM (Modelo de Objeto do Documento) e é imposto pelo design de criação de fábrica na classe XmlDocument. Por exemplo, CreateElement é a única maneira de criar novos nós.

Dependendo do tipo do nó importado e do valor do parâmetro deep, informações adicionais são copiadas conforme apropriado. Este método tenta espelhar o comportamento esperado se um fragmento XML ou de código HTML foi copiado de um documento para outro, responsabilizando-se pelo fato que para XML, os dois documentos pode ter definições de tipos diferentes (DTDs) do documento.

A tabela a seguir descreve o comportamento específico para cada tipo de nó que pode ser importado.

Tipo de nó O parâmetro deep é true O parâmetro deep é false
XmlAttribute O Specified é definido como true no XmlAttribute. Os descendentes da origem XmlAttribute são importados recursivamente, e os nós resultantes são remontados para formar a subárvore correspondente. O parâmetro deep não se aplica a nós XmlAttribute, pois eles sempre levam seus filhos quando importados.
XmlCDataSection Copia o nó, incluindo seus dados. Copia o nó, incluindo seus dados.
XmlComment Copia o nó, incluindo seus dados. Copia o nó, incluindo seus dados.
XmlDocumentFragment Os descendentes nó de origem recursivamente serão importados e os nós resultantes são remontados para formar a subárvore correspondente. Um XmlDocumentFragment vazio é criado.
XmlDocumentType Copia o nó, incluindo seu data.* Copia o nó, incluindo seu data.*
XmlElement Os descendentes do elemento de origem recursivamente serão importados e os nós resultantes são remontados para formar a subárvore correspondente. Observação: os atributos padrão não são copiados. Se o documento que está sendo importado define atributos padrão para este nome de elemento, esses são atribuídos. Os nós de atributo especificados do elemento de origem são importados, e os nós XmlAttribute gerados são anexados ao novo elemento. Os nós descendentes não são copiados. Observação: os atributos padrão não são copiados. Se o documento que está sendo importado define atributos padrão para este nome de elemento, esses são atribuídos.
XmlEntityReference Como os documentos de origem e destino podem ter as entidades definidas de maneira diferente, esse método copia somente o nó XmlEntityReference. O texto de substituição não é incluído. Se o documento de destino tem a entidade definida, o valor é atribuído. Como os documentos de origem e destino podem ter as entidades definidas de maneira diferente, esse método copia somente o nó XmlEntityReference. O texto de substituição não é incluído. Se o documento de destino tem a entidade definida, o valor é atribuído.
XmlProcessingInstruction Copia o destino e o valor do nó importado. Copia o destino e o valor do nó importado.
XmlText Copia o nó, incluindo seus dados. Copia o nó, incluindo seus dados.
XmlSignificantWhitespace Copia o nó, incluindo seus dados. Copia o nó, incluindo seus dados.
XmlWhitespace Copia o nó, incluindo seus dados. Copia o nó, incluindo seus dados.
XmlDeclaration Copia o destino e o valor do nó importado. Copia o destino e o valor do nó importado.
Todos os outros tipos de nó Esses tipos de nós não podem ser importados. Esses tipos de nós não podem ser importados.

Observação

Embora os nós de DocumentType possam ser importados, um documento pode ter apenas um DocumentType. Assim, uma vez que você importou o tipo de documento, antes de inseri-lo na árvore você precisará certificar-se que não há documento tipo no documento. Para saber mais sobre como remover nós, confira Removendo nós, conteúdo e valores de um documento XML.

Confira também