Copia di nodi esistenti da un documento all'altro

Il metodo ImportNode è il meccanismo con il quale un nodo o un intero sottoalbero di nodi viene copiato da un oggetto XmlDocument a un altro. Il nodo restituito dalla chiamata è una copia del nodo dal documento di origine, inclusi i valori degli attributi, il nome del nodo, il tipo di nodo e tutti gli attributi relativi allo spazio dei nomi quali il prefisso, il nome locale e l'URI dello spazio dei nomi. Il documento di origine non viene modificato. Dopo aver importato il nodo, è necessario aggiungerlo alla struttura ad albero utilizzando uno dei metodi di inserimento dei nodi.

Quando il nodo viene associato al documento nuovo, quest'ultimo possiede il nodo, perché ogni nodo, al momento della creazione, ha un documento che lo possiede, anche se i nodi vengono creati in frammenti di documento separati. Si tratta di un requisito del modello DOM (Document Object Model) XML ed è imposto a livello di fabbrica nella progettazione della creazione per la classe XmlDocument. Ad esempio, CreateElement è l'unico metodo che consente di creare nuovi nodi.

A seconda del tipo di nodo del nodo importato e del valore del parametro deep, vengono copiate informazioni aggiuntive. Questo metodo tenta di rispecchiare il comportamento previsto nel caso in cui un frammento di codice XML o HTML sia stato copiato da un documento all'altro, tenendo conto del fatto che per il codice XML i due documenti potrebbero avere DTD diverse.

Nella tabella seguente viene descritto il comportamento specifico di ogni tipo di nodo che è possibile importare.

Tipo di nodo	Il parametro deep è true	Il parametro deep è false
XmlAttribute	La Proprietà XmlAttribute.Specified viene impostata su true nell'XmlAttribute. Gli elementi discendenti dell'oggetto XmlAttribute di origine vengono importati in modo ricorsivo e i nodi risultanti vengono riassemblati per formare il sottoalbero corrispondente.	Il parametro deep non è applicabile ai nodi XmlAttribute, in quanto questi restano sempre associati ai nodi figlio durante l'importazione.
XmlCDataSection	Copia il nodo, compresi i dati.	Copia il nodo, compresi i dati.
XmlComment	Copia il nodo, compresi i dati.	Copia il nodo, compresi i dati.
XmlDocumentFragment	Gli elementi discendenti del nodo di origine vengono importati in modo ricorsivo e i nodi risultanti vengono riassemblati per formare il sottoalbero corrispondente.	Viene creato un XmlDocumentFragment vuoto.
XmlDocumentType	Copia il nodo, compresi i dati.*	Copia il nodo, compresi i dati.*
XmlElement	Gli elementi discendenti dell'elemento di origine vengono importati in modo ricorsivo e i nodi risultanti vengono riassemblati per formare il sottoalbero corrispondente. Nota Gli attributi predefiniti non vengono copiati.Se il documento verso il quale avviene l'importazione definisce attributi predefiniti per questo nome di elemento, verranno assegnati tali attributi.	I nodi Attribute specificati dell'elemento di origine vengono importati e i nodi XmlAttribute generati vengono associati al nuovo elemento. I nodi discendenti non vengono copiati. Nota Gli attributi predefiniti non vengono copiati.Se il documento verso il quale avviene l'importazione definisce attributi predefiniti per questo nome di elemento, verranno assegnati tali attributi.
XmlEntityReference	Poiché nei documenti di origine e di destinazione le entità potrebbero essere definite in modo diverso, questo metodo copia solo il nodo XmlEntityReference. Il testo di sostituzione non viene incluso. Se nel documento di destinazione l'entità è definita, viene assegnato il suo valore.	Poiché nei documenti di origine e di destinazione le entità potrebbero essere definite in modo diverso, questo metodo copia solo il nodo XmlEntityReference. Il testo di sostituzione non viene incluso. Se nel documento di destinazione l'entità è definita, viene assegnato il suo valore.
XmlProcessingInstruction	Copia il valore di destinazione e dei dati dal nodo importato.	Copia il valore di destinazione e dei dati dal nodo importato.
XmlText	Copia il nodo, compresi i dati.	Copia il nodo, compresi i dati.
XmlSignificantWhitespace	Copia il nodo, compresi i dati.	Copia il nodo, compresi i dati.
XmlWhitespace	Copia il nodo, compresi i dati.	Copia il nodo, compresi i dati.
XmlDeclaration	Copia il valore di destinazione e dei dati dal nodo importato.	Copia il valore di destinazione e dei dati dal nodo importato.
Tutti gli altri tipi di nodo	Questi nodi non possono essere importati.	Questi nodi non possono essere importati.

Nota
Sebbene sia possibile importare nodi DocumentType, un documento può disporre di un unico DocumentType.Pertanto, una volta importato il tipo di documento, prima di inserirlo nella struttura ad albero è necessario verificare che non sia presente alcun tipo di documento nel documento stesso.Per informazioni sulla rimozione dei nodi, vedere Rimozione di nodi, contenuto e valori da un documento XML.

Vedere anche

Concetti

Modello DOM (Document Object Model) XML