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

Метод CreateEntityReference создает новый узел XmlEntityReference . Объектная модель XML-документа (DOM) проверяет, уже объявлено ли имя сущности. Если он имеется, дочерние узлы узла XmlEntityReference копируются из узла объявления сущности. Если нет соответствующего объявления сущности, пустой текстовый узел становится единственным дочерним узлом ссылки на сущность. Так как дочерние узлы узла XmlEntityReference копируют другие узлы, эти дочерние узлы доступны только для чтения и не могут быть изменены.

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

Замечание

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

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

См. также

• Объектная модель XML-документа (DOM)