Criando novas referências de entidade

O método CreateEntityReference cria um novo nó XmlEntityReference. O DOM (Modelo de Objeto de Documento XML) procura ver se o nome da entidade que está sendo referenciado já foi declarado. Se ele tiver sido, os nós filho do nó XmlEntityReference serão copiados do nó de declaração de entidade. Se não houver nenhuma declaração de entidade que corresponde, um nó vazia de texto é anexado como o único filho do nó de referência de entidade. Como os nós filhos do nó XmlEntityReference são cópias de outros nós, esses nós filhos são somente para leitura e não podem ser modificados.

Quando os nós são copiados, pode haver namespace no escopo na referência de entidade. Esse namespace afeta a configuração de qualquer elemento ou nós de atributo gerados.

Embora o XmlDataDocument seja uma classe derivada do XmlDocument, o XmlDataDocument não dá suporte à criação de referências de entidade. Isso ocorre porque os filhos de EntityReference são somente leitura. Os filhos de um nó EntityReference podem abranger mais de uma região. Nesse caso, a parte de uma linha associada à região que contém uma parte de EntityReference será somente leitura.

Consulte também

• Modelo de objeto de documento XML (DOM)