Создание новых ссылок на сущности

Метод CreateEntityReference создает новый узел XmlEntityReference. Модель DOM определяет, было ли уже декларировано имя сущности, на которую указывает ссылка. Если было, то дочерние узлы узла XmlEntityReference копируются из узла декларации сущности. Если совпадающая декларация сущности отсутствует, пустой текстовый узел прикрепляется как единственный дочерний узел узла ссылки на сущность. Так как дочерние узлы узла XmlEntityReference являются копиями других узлов, они доступны только для чтения и не могут быть изменены.

При копировании узлов в области в точке ссылки на сущность может быть пространство имен. Это пространство имен влияет на конфигурацию всех формируемых элементов или узлов атрибутов.

Примечание.

Модель DOM добавляет дочерние узлы к узлу EntityReference только при вставке в документ узла EntityReference. Вновь созданные узлы EntityReference не имеют дочерних узлов.

Хотя класс XmlDataDocument является производным от класса XmlDocument, класс XmlDataDocument не поддерживает создание ссылок на сущности. Это связано с тем, что дочерние узлы EntityReference доступны только для чтения. Дочерние узлы узла EntityReference могут принадлежать к нескольким областям. В этом случае часть строки, связанная с областью, которая содержит часть узла EntityReference, будет доступна только для чтения.

См. также

• Модель объектов документов XML (DOM)