Creazione di nuovi riferimenti alle entitàCreating New Entity References

Il metodo CreateEntityReference consente di creare un nuovo nodo XmlEntityReference.The CreateEntityReference method creates a new XmlEntityReference node. Il modello DOM XML cerca di vedere se il nome dell'entità a cui si fa riferimento è già stato dichiarato.The XML Document Object Model (DOM) looks to see if the entity name being referenced has already been declared. In caso affermativo, i nodi figlio del nodo XmlEntityReference vengono copiati dal nodo della dichiarazione di entità.If it has, the child nodes of XmlEntityReference node are copied from the entity declaration node. Se non vi è alcuna dichiarazione di entità corrispondente, viene associato un nodo di testo vuoto come unico figlio del nodo del riferimento all'entità.If there is no entity declaration that matches, an empty text node is attached as the only child of the entity reference node. Poiché i nodi figlio del nodo XmlEntityReference sono copie di altri nodi, questi nodi figlio sono di sola lettura e non è possibile modificarli.Because the child nodes of the XmlEntityReference node are copies of other nodes, these child nodes are read-only and cannot be modified.

Dopo aver copiato i nodi, è probabile che vi sia uno spazio dei nomi nell'area di validità nel punto del riferimento all'entità.When the nodes are copied, there may be a namespace in scope at the point of the entity reference. Tale spazio dei nomi incide sulla configurazione di qualsiasi nodo di elemento o di attributo generato.This namespace affects the configuration of any element or attribute nodes generated.

Nota

Il modello DOM aggiunge nodi figlio a EntityReference solo quando si inserisce il nodo EntityReference nel documento.The DOM adds child nodes to the EntityReference only when you insert the EntityReference node to the document. I nodi EntityReference appena creati non hanno nodi figlio.Newly created EntityReference nodes have no child nodes.

Anche se XmlDataDocument è una classe derivata di XmlDocument, XmlDataDocument non supporta la creazione di riferimenti alle entità,Even though the XmlDataDocument is a derived class of the XmlDocument, the XmlDataDocument does not support the creation of entity references. perché gli elementi figlio di EntityReference sono di sola lettura.This is because EntityReference children are read-only. I nodi figlio di un nodo EntityReference possono interessare più di un'area.The children of an EntityReference node can span more than one region. In tal caso, la parte di riga associata all'area contenente una parte di EntityReference sarà di sola lettura.In this case, part of a row associated with the region that contains a part of an EntityReference will be read-only.

Vedere ancheSee Also

Modello DOM (Document Object Mode) XMLXML Document Object Model (DOM)