Creazione di nuovi riferimenti alle entità

Il metodo CreateEntityReference consente di creare un nuovo nodo XmlEntityReference. Il modello DOM XML cerca di vedere se il nome dell'entità a cui si fa riferimento è già stato dichiarato. In caso affermativo, i nodi figlio del nodo XmlEntityReference vengono copiati dal nodo della dichiarazione di entità. Se non vi è alcuna dichiarazione di entità corrispondente, viene associato un nodo di testo vuoto come unico figlio del nodo del riferimento all'entità. Poiché i nodi figlio del nodo XmlEntityReference sono copie di altri nodi, questi nodi figlio sono di sola lettura e non è possibile modificarli.

Dopo aver copiato i nodi, è probabile che vi sia uno spazio dei nomi nell'area di validità nel punto del riferimento all'entità. Tale spazio dei nomi incide sulla configurazione di qualsiasi nodo di elemento o di attributo generato.

Nota

Il modello DOM aggiunge nodi figlio a EntityReference solo quando si inserisce il nodo EntityReference nel documento. I nodi EntityReference appena creati non hanno nodi figlio.

Anche se XmlDataDocument è una classe derivata di XmlDocument, XmlDataDocument non supporta la creazione di riferimenti alle entità, perché gli elementi figlio di EntityReference sono di sola lettura. I nodi figlio di un nodo EntityReference possono interessare più di un'area. In tal caso, la parte di riga associata all'area contenente una parte di EntityReference sarà di sola lettura.

Vedi anche

• Modello DOM (Document Object Mode) XML