Сопоставление объектной иерархии с XML-данными
Когда XML-документ находится в памяти, его концептуальным представлением является дерево. В распоряжении программиста имеется объектная иерархия для доступа к узлам этого дерева. Следующий пример показывает, как XML-содержимое становится узлами.
При считывании XML в модель DOM, его фрагменты преобразуются в узлы, и эти узлы сохраняют дополнительные метаданные о себе, в частности, тип узла и значения. Тип узла - это его объект и характеристики, определяющие выполняемые действия и свойства, которые можно установить и получить.
Если имеется следующий простой XML:
Входные данные
<book>
<title>The Handmaid's Tale</title>
</book>
Входные данные представлены в памяти следующим деревом узлов с назначенным свойством типа узлов:
Представление дерева узлов book и title
Элемент book становится объектом XmlElementtitle, следующий элемент также становится объектом XmlElement, а элемент content становится объектом XmlText. Методы и свойства объекта XmlElement отличаются от методов и свойств, доступных для объекта XmlText. Поэтому очень важно знать, какой тип узла получает XML, так как тип узла определяет действия, которые можно выполнить.
В следующих примерах выполняется считывание XML-данных и запись другого текста, в зависимости от типа узла. Использование следующего XML-файла items.xml для получения входных данных.
Входные данные
<?xml version="1.0"?>
<!-- This is a sample XML document -->
<!DOCTYPE Items [<!ENTITY number "123">]>
<Items>
<Item>Test with an entity: &number;</Item>
<Item>test with a child element <more/> stuff</Item>
<Item>test with a CDATA section <![CDATA[<456>]]> def</Item>
<Item>Test with a char entity: A</Item>
<!-- Fourteen chars in this element.-->
<Item>1234567890ABCD</Item>
</Items>
Следующий пример кода считывает файл items.xml и отображает сведения о типах узлов.
Imports System
Imports System.IO
Imports System.Xml
Public Class Sample
Private Const filename As String = "items.xml"
Public Shared Sub Main()
Dim reader As XmlTextReader = Nothing
Try
' Load the reader with the data file and
'ignore all white space nodes.
reader = New XmlTextReader(filename)
reader.WhitespaceHandling = WhitespaceHandling.None
' Parse the file and display each of the nodes.
While reader.Read()
Select Case reader.NodeType
Case XmlNodeType.Element
Console.Write("<{0}>", reader.Name)
Case XmlNodeType.Text
Console.Write(reader.Value)
Case XmlNodeType.CDATA
Console.Write("<![CDATA[{0}]]>", reader.Value)
Case XmlNodeType.ProcessingInstruction
Console.Write("<?{0} {1}?>", reader.Name, reader.Value)
Case XmlNodeType.Comment
Console.Write("<!--{0}-->", reader.Value)
Case XmlNodeType.XmlDeclaration
Console.Write("<?xml version='1.0'?>")
Case XmlNodeType.Document
Case XmlNodeType.DocumentType
Console.Write("<!DOCTYPE {0} [{1}]", reader.Name, reader.Value)
Case XmlNodeType.EntityReference
Console.Write(reader.Name)
Case XmlNodeType.EndElement
Console.Write("</{0}>", reader.Name)
End Select
End While
Finally
If Not (reader Is Nothing) Then
reader.Close()
End If
End Try
End Sub 'Main ' End class
End Class 'Sample
using System;
using System.IO;
using System.Xml;
public class Sample
{
private const String filename = "items.xml";
public static void Main()
{
XmlTextReader reader = null;
try
{
// Load the reader with the data file and ignore
// all white space nodes.
reader = new XmlTextReader(filename);
reader.WhitespaceHandling = WhitespaceHandling.None;
// Parse the file and display each of the nodes.
while (reader.Read())
{
switch (reader.NodeType)
{
case XmlNodeType.Element:
Console.Write("<{0}>", reader.Name);
break;
case XmlNodeType.Text:
Console.Write(reader.Value);
break;
case XmlNodeType.CDATA:
Console.Write("<![CDATA[{0}]]>", reader.Value);
break;
case XmlNodeType.ProcessingInstruction:
Console.Write("<?{0} {1}?>", reader.Name, reader.Value);
break;
case XmlNodeType.Comment:
Console.Write("<!--{0}-->", reader.Value);
break;
case XmlNodeType.XmlDeclaration:
Console.Write("<?xml version='1.0'?>");
break;
case XmlNodeType.Document:
break;
case XmlNodeType.DocumentType:
Console.Write("<!DOCTYPE {0} [{1}]", reader.Name, reader.Value);
break;
case XmlNodeType.EntityReference:
Console.Write(reader.Name);
break;
case XmlNodeType.EndElement:
Console.Write("</{0}>", reader.Name);
break;
}
}
}
finally
{
if (reader != null)
reader.Close();
}
}
} // End class
Вывод примера содержит сопоставление данных типам узлов.
Выходные данные
<?xml version='1.0'?><!--This is a sample XML document --><!DOCTYPE Items [<!ENTITY number "123">]<Items><Item>Test with an entity: 123</Item><Item>test with a child element <more> stuff</Item><Item>test with a CDATA section <![CDATA[<456>]]> def</Item><Item>Test with a char entity: A</Item><--Fourteen chars in this element.--><Item>1234567890ABCD</Item></Items>
Рассматривая входные данные построчно и используя выход, сформированный кодом, можно использовать следующую таблицу для анализа того, какой узел сформировал конкретные строки результата, и понять, какие XML-данные стали соответствующими типами узлов.
| Входные данные | Выходные данные | Проверка типа узла |
|---|---|---|
| <?xml version="1.0"?> | <?xml version='1.0'?> | XmlNodeType.XmlDeclaration |
| <-- Это пример XML-документа.> | <--This — это пример XML-документа.> | XmlNodeType.Comment |
| <! Элементы DOCTYPE [<! Номер сущности "123">]> | <! Элементы DOCTYPE [<! Номер сущности "123">] | XmlNodeType.DocumentType |
| <Товаров> | <Товаров> | XmlNodeType.Element |
| <Элемент> | <Элемент> | XmlNodeType.Element |
| Тестирование с помощью сущности: &number; | Test with an entity: 123 | XmlNodeType.Text |
| </Элемента> | </Элемента> | XmlNodeType.EndElement |
| <Элемент> | <Элемент> | XmNodeType.Element |
| test with a child element | test with a child element | XmlNodeType.Text |
| <more> | <more> | XmlNodeType.Element |
| stuff | stuff | XmlNodeType.Text |
| </Элемента> | </Элемента> | XmlNodeType.EndElement |
| <Элемент> | <Элемент> | XmlNodeType.Element |
| test with a CDATA section | test with a CDATA section | XmlTest.Text |
| <! [CDATA[<456>]]> | <! [CDATA[<456>]]> | XmlTest.CDATA |
| def | def | XmlNodeType.Text |
| </Элемента> | </Элемента> | XmlNodeType.EndElement |
| <Элемент> | <Элемент> | XmlNodeType.Element |
| Тестирование с помощью сущности char: A | Test with a char entity: A | XmlNodeType.Text |
| </Элемента> | </Элемента> | XmlNodeType.EndElement |
| <-- Четырнадцать символов в этом элементе.-> | <--14 chars в этом элементе.--> | XmlNodeType.Comment |
| <Элемент> | <Элемент> | XmlNodeType.Element |
| 1234567890ABCD | 1234567890ABCD | XmlNodeType.Text |
| </Элемента> | </Элемента> | XmlNodeType.EndElement |
| </Элементы> | </Элементы> | XmlNodeType.EndElement |
Необходимо знать, какой тип узла назначен, так как от типа узла зависят допустимые типы действий и типы свойств, которые можно установить и получить.
Управление созданием узлов для пробелов при загрузке данных в модель DOM осуществляется флагом PreserveWhitespace. Дополнительные сведения см. в руководстве по обработке незначимых и значимых пробелов при загрузке модели DOM.
Чтобы добавить новые узлы в модель DOM, воспользуйтесь руководством Вставка узлов в XML-документ. Чтобы удалить узлы из модели DOM, изучите статью Удаление узлов, содержимого и значений из XML-документа. Чтобы изменить узлы в модели DOM, см. статью Изменение узлов, содержимого и значений в XML-документе.
