Файл: Методические указания по выполнению лабораторных работ по дисциплине (модулю) Лингвистическое и программное обеспечение автоматизированных систем.doc

определяющие ссылку на общую сущность, оно ищет это имя в таблице деклараций сущностей. Ссылка &publisher; заменяется содержимым, которое она представляет. Используя следующий XML-код,

Fred

Published by &publisher;

разворачивает ссылку на сущность и заменяет &publisher; содержимым Microsoft Press, формируя следующий расширенный XML.

Выходныеданные

Fred

Published by Microsoft Press

Существует много типов сущностей. На следующей схеме показана классификация типов сущности и терминология.



По умолчанию реализация модели DOM на платформе Microsoft .NET Framework сохраняет ссылки на сущности и не развертывает их при загрузке XML. Это означает, что при загрузке документа в модель DOM создается узел XmlEntityReference_publisher;_,_содержащий_ссылочную_переменную'>XmlEntityReference&publisher;, содержащий ссылочную переменную , с дочерними узлами, представляющими содержимое сущности, объявленной в определении DTD.

Следующая схема на примере объявления сущности демонстрирует узлы XmlEntity и XmlText, создаваемые на основе этого объявления.



Будут ли развертываться ссылки на сущности или нет - зависит от вида узлов, создаваемых в дереве модели DOM в памяти.

2.23. Сохраняемые ссылки на сущности

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

Используя следующий XML-код,

Fred

Published by &publisher;

Модель DOM строит узел XmlEntityReference, когда встречает ссылку &publisher;. Узел XmlEntityReference содержит дочерние узлы, которые копируются из содержимого декларации сущности. В предыдущем примере присутствует текст в декларации сущности, поэтому узел XmlText создается как дочерний узел для узла ссылки на сущность.


Древовидная структура для сохраняемых ссылок на сущности

Дочерние узлы XmlEntityReference являются копиями всех дочерних узлов, созданных из узла

---

XmlEntity в момент, когда была обнаружена декларация сущности.

Примечание

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

По умолчанию сохраняются сущности общего вида, такие как &abc;, и всегда создаются узлы XmlEntityReference.

---

2.24. Разворачиваемые и не сохраняемые ссылки на сущности

Если ссылка на сущность разворачивается и заменяется текстом, который она представляет, узел XmlEntityReference не создается. Вместо этого выполняется синтаксический анализ для декларации сущности и на место XmlEntityReference копируются узлы, созданные из содержимого этой декларации. Таким образом, в примере &publisher; ссылка &publisher; не сохраняется, а вместо нее создается узел XmlText.


Древовидная структура для разворачиваемых ссылок на сущности

Сущности-символы, такие как B и <, не сохраняются. Вместо этого они всегда разворачиваются и представляются в виде текстовых узлов.

Чтобы сохранить узлы XmlEntityReference и дочерние узлы в присоединенной у ней ссылке на сущности, установите флаг EntityHandling в значение ExpandCharEntities. В противном случае оставьте для флага EntityHandling значение по умолчанию - ExpandEntities. В этом случае узлы ссылок на сущности не будут отображаться в модели DOM. Эти узлы замещаются узлами-копиями дочерних узлов декларации сущности.

Один побочный эффект от несохранения ссылок на сущности состоит в том, что после сохранения документа и передачи его в другое приложение этому приложению будет неизвестно, что узлы были порождены ссылкой на сущность. Если же ссылки на сущности сохраняются, то принимающее приложение, обнаружив ссылку на сущность, считает ее дочерние узлы. Очевидно, что дочерние узлы представляют данные, находившиеся в декларации сущности. Например, модель DOM в случае сохранения ссылок на сущности теоретически имела бы следующую структуру.

XmlElement: publisher

XmlEntityReference: &publisher;

XmlText: Microsoft Press

Если ссылки на сущности разворачиваются в модели DOM (метод по умолчанию), древовидная структура имеет следующий вид:

XmlElement: publisher

XmlText: Microsoft Press

Обратите внимание, что ссылка на сущность отсутствует и принимающее приложение не может определить, что узел XmlText со значением "Microsoft Press" был создан из декларации сущности.

---

Если используется модуль чтения, который не умеет разрешать сущности, метод Load создает исключение, когда обнаруживает ссылку на сущность.

2.25. Создание новых узлов в модели DOM

К классе XmlDocument доступен метод для создания всех типов узлов. Для создания узла методу нужно передать имя (если необходимо) и содержимое или другие параметры для узлов, имеющих содержимое (например, текстовый узел). Далее представлены методы, которым необходимо передать имя и некоторые другие параметры для создания нужного узла.

• 
  CreateCDataSection
  
• 
  CreateComment
  
• 
  CreateDocumentFragment
  
• 
  CreateDocumentType
  
• 
  CreateElement
  
• 
  CreateNode
  
• 
  CreateProcessingInstruction
  
• 
  CreateSignificantWhitespace
  
• 
  CreateTextNode
  
• 
  CreateWhitespace
  
• 
  CreateXmlDeclaration
  

Для других типов узлов недостаточно просто задать данные параметров.

После создания новых узлов становятся доступны несколько методов для вставки узлов в дерево. В таблице перечислены методы и описано место появления нового узла в модели XML DOM.

Таблица 2.15

Метод	Размещение узла
InsertBefore	Вставляется перед узлом ссылки. Например, следующий код вставляет новый узел в позицию 5: Dim refChild As XmlNode = node.ChildNodes(4) 'The reference is zero-based.node.InsertBefore(newChild, refChild); XmlNode refChild = node.ChildNodes[4]; //The reference is zero-based. node.InsertBefore(newChild, refChild); Дополнительные сведения см. в описании метода InsertBefore.
InsertAfter	Вставляется после узла ссылки. Пример: node.InsertAfter(newChild, refChild) node.InsertAfter(newChild, refChild); Дополнительные сведения см. в описании метода InsertAfter.
AppendChild	Добавляет узел в конец списка дочерних узлов заданного узла. Если добавляемый узел представляет собой XmlDocumentFragment, все содержимое фрагмента документа перемещается в дочерний список этого узла. Дополнительные сведения см. в описании метода AppendChild.
PrependChild	Добавляет узел в начало списка дочерних узлов заданного узла. Если добавляемый узел представляет собой XmlDocumentFragment, все содержимое фрагмента документа перемещается в дочерний список этого узла. Дополнительные сведения см. в описании метода PrependChild.
Append	Добавляет узел XmlAttribute в конец коллекции атрибутов, связанной с элементом. Дополнительные сведения см. в описании метода Append.

---

---