XML играет очень большую роль в платформе .NET. Платформа не только позволяет использовать XML в приложениях, но сама применяет XML для таких вещей, как конфигурационные файлы и документация исходного кода. Для XML платформа .NET содержит пространство имен

System.Xml

В этой главе говорится о том, как использовать реализацию DOM, и что предлагает .NET в качестве замены SAX. Будет показана совместная работа XML и ADO.NET и их преобразования. Мы узнаем так же, как можно сериализовать объекты в документ XML и создать объект из документа XML (десериализовать). Кроме того увидим, как включать XML в приложения C#. Следующие классы будут рассмотрены более подробно:

□

XmlReader

XmlTextReader

□

XmlWriter

XmlTextWriter

□

XmlDocument

□

XPath

XslTransform

□

ADO.NET

XmlDataDocument

□

XmlSerialization

Начнем эту главу с текущего состояния стандартов XML.

Консорциум WWW (W3C) разработал множество стандартов, придающих XML мощь и потенциал. Без этих стандартов XML не смог бы оказать такого большого влияния на мир разработки. В этой книге не будут подробно рассматриваться тонкости XML. Для этого необходимо использовать другие источники. Среди книг Wrox, переведенных издательством "Лори", можно порекомендовать "Введение в XML" (2001 г., 656 стр.), "XML для профессионалов" (2001 г., 896 стр.) и "The XML Handbook" (ISBN 0-13-055068). Конечно, web-сайт W3C является ценным источником информации о XML (www.w3.org). В мае 2001 г. платформа .NET поддерживала следующие стандарты:

□ XML 1.0 — www.w3.org/TR/1998/REC-XML-19980210 — включая поддержку DTD (

XmlTextReader

□ Пространства имен XML — www.w3.org/TR/REC-xml-names — уровень потока и DOM.

□ Схемы XML — www.w3.org/TR/xmlschema-1 — поддерживается отображение схем и сериализация, но пока еще не поддерживается проверка.

□ Выражения XPath — www.w3.org/TR/xpath

□ Преобразования XSL/T — www.w3.org/TR/xslt

□ Ядро DOM Level 2 — www.w3.org/TR/DOM-Level-2

□ Soap 1.1 — msdn.microsoft.com/xml/general/soapspec.asp

Уровень поддержки стандартов будет меняться по мере развития платформы и по мере того, как W3C продолжает обновлять рекомендованные стандарты. В связи с этим необходимо всегда оставаться на современном уровне стандартов и уровне поддержки, который обеспечивает Microsoft.

Рассмотрим (без определенного порядка) некоторые классы пространства имен System.Xml.

XML является также частью пространства имен

System.Data

DataSet

Необходимо отметить, что эта книга посвящена языку C#, поэтому все примеры будут написаны на C#. Однако пространство имен XML доступно в любом языке, который является частью семейства .NET. Это означает, что все приведенные примеры могли быть также написаны на языках VB.NET, Управляемый C++ и т.д.

Как быть, если имеется большой объем кода, разработанного с помощью синтаксического анализатора компании Microsoft (в настоящее время XML 3.0)? Придется ли его выбросить и начать все сначала? А что если вам удобно использовать объектную модель XML 3.0 DOM? Нужно ли немедленно переключаться на .NET?

Ответом будет — нет. XML 3.0 может использоваться непосредственно в приложениях. Если добавить ссылку на msxml3.DLL в свое решение, то можно будет начать писать некоторый код.

Следующие несколько примеров будут использовать файл books.xml в качестве источника данных. Его можно загрузить с web-сайта издательства Wrox, он также включен в несколько примеров .NET SDK. Файл books.xml является каталогом книг воображаемого книжного склада. Он содержит такую информацию, как жанр, имя автора, цена и номер ISBN. Все примеры кода в этой главе также доступны на web-сайте издательства Wrox: www.wrox.com. Чтобы выполнить эти примеры, файлы данных XML должны находиться в структуре путей, которая выглядит примерно следующим образом:

/XMLChapter/Sample1

/XMLChapter/Sample2

/XMLChapter/Sample3

и т. д. Файлы XML должны находиться в подкаталоге XMLChapter, а код для примеров должен быть в подкаталогах Sample1, Sample2 и т.д. Можно называть каталоги как угодно, но их относительное положение важно. Можно также изменять примеры, чтобы указать желаемое направление. В коде примеров будут сделаны указания, какие строки изменить.

Файл books.xml выглядит следующим образом:

<?xml version='1.0'?>

<!-- Этот файл представляет фрагмент базы данных учета запасов книжного склада -->

<bookstore>

 <book genre="autobiography" publicationdate="1981" ISBN="1-861003-11-0">

  <title>The Autobiography of Benjamin Franklin</title>

  <author>

   <first-name>Benjamin</first-name>

   <last-name>Franklin</last-name>

  </author>

  <price>8.99</price>

 </book>

 <book genre="novel" publicationdate="1967" ISBN="0-201-63361-2">

  <title>The Confidence Man</title>

  <author>

   <first-name>Herman</first-name>

   <last-name>Melville</last-name>

  </author>

  <price>11.99</price>

 </book>

 <book genre="philosophy" publicationdate="1991" ISBN="1-861001-57-6"> 

  <title>The Gorgias</title>

  <author>

   <name>Plato</name>

  </author>

  <price>9.99</price>

 </book>

</bookstore>

Рассмотрим пример кода, использующего MSXML 3.0 для загрузки окна списка с номерами ISBN из

books.xml

SampleBase1

listbox

button

listBox1

button1

namespace SampleBase {

 using System;

 using System.Drawing;

 using System.Collections;

 using System.ComponentModel;

 using System.Windows.Forms;

 using System.Data;

Затем включается пространство имен для ссылки на

msxml3.dll

 using MSXML2;

 /// <summary>

 /// Краткое описание Form1.

 /// </summary>

 public class Form1 : System.Windows.Forms.Form {

  private System.Windows.Forms.ListBox listBox1;

  private System.Windows.Forms.Button button1;

  /// <summary>

  /// Необходимая для Designer переменная.

  /// </summary>

  private System.ComponentModel.Container components;

Затем объявляется документ DOM на уровне модуля:

  private DOMDocument30 doc;

  public Form1() {

   //

   // Требуется для поддержки Windows Form Designer

   //

   InitializeComponent();

   //

   // TODO: Добавьте любой код конструктора после вызова

   // InitializeComponent

   //

  }

  /// <summary>

  /// Очистить все использованные ресурсы.

  /// </summary>

  public override void Disposed {

   base.Dispose();

   if (components != null) components.Dispose();

  }

#region Windows Form Designer создает код

  /// <summary>

  /// Необходимый для поддержки Designer метод — не изменяйте

  /// содержимое этого метода редактором кода.

  /// </summary>

  private void InitializeComponent() {

   this.listBox1 = new System.Windows.Forms.ListBox();

   this.button1 = new System.Windows.Forms.Button();

   this.listBox1.Anchor = ((System.Windows.Forms.AnchorStyles.Top |

    System.Windows.Forms.AnchorStyles.Left) |

    System.Windows.Forms.AnchorStyles.Right);

   this.listBox1.Size = new System.Drawing.Size(336, 238);

   this.listBox1.TabIndex = 0;

   this.listBox1.SelectedIndexChanged += new System.EventHandler(this.listBox1_SelectedIndexChanged);

   this.button1.Anchor = System.Windows.Forms.AnchorStyles.Bottom;

   this.button1.Location = new System.Drawing.Point(136, 264);

   this.button1.TabIndex = 1;

   this.button1.Text = "button1";

   this.button1.Click += new System.EventHandler(this.button1_Click);

   this.AutoScaleBaseSize = new System.Drawing.Size(5, 13);

   this.ClientSize = new System.Drawing.Size(339, 320);

   this.Controls.AddRange(new System.Windows.Forms.Control[]{this.button1, this.listBox1});

   this.Text = "Form1";

  }

#endregion

  /// <summary>

  /// Главная точка входа для приложения.

  /// </summary>

  [STAThread]

  static void Main() {

   Application.Run(new Form1());

  }

Мы хотим взять номер ISBN из

listbox

XPath

MessageBox

  protected void listBox1_SelectedIndexChanged (object sender, System.EventArgs e){

   string srch=listBox1.SelectedItem.ToString();

   IXMLDOMNode nd=doc.selectSingleNode("bookstore/book[@ISBN='" + srch + "']");

   MessageBox.Show(nd.text);

  }

Теперь мы имеем обработчик события нажатия кнопки. Сначала мы загружаем файл

books.xml

bin/debug

bin/release

  protected void button1_Click(object sender, System.EventArgs e) {

   doc=new DOMDocument30();

   doc.load("..\\..\\..\\books.xml")

Следующие строки объявляют, что узлы являются

nodeList

   IXMLDOMNodeList nodes;

   nodes = doc.selectNodes("bookstore/book");

   IXMLDOMNode node=nodes.nextNode();

Мы просматриваем узлы в цикле и добавляем текстовое значение атрибута ISBN в

listBox1

   while(node!=null) {

    listBox1.Items.Add(node.attributes.getNamedItem("ISBN").text);

    node=nodes.nextNode();

   }

  }

 }

}

Вот как выглядит пример во время выполнения:

Это изображение появляется после того, как была нажата кнопка button1 и загрузился listBox1 с номерами ISBN книг. После выбора номера ISBN будет выведено следующее:

Пространство имен

System.Xml

System.Xml

System.Xml

Этот файл XML будет использоваться в примерах этой главы. Код, который только что был рассмотрен, лежит в основе нескольких примеров. В большинстве других будет показан только код, имеющий отношение к делу, и не будет повторяться то, что уже было показано.

Теперь посмотрим, что позволяет делать платформа .NET. Если раньше вы работали с SAX, то

XmlReader

XmlWriter

XmlReader

XmlWriter

XmlReader

XmlWriter

XmlReader

XmlWriter

XmlTextReader

XmlTextWriter

TextReader

TextWriter

XmlNodeReader

XmlNode

XmlValidatingReader

XmlTextReader

XmlTextReader

Возьмем простой пример считывания данных XML, и затем более внимательно рассмотрим класс

XmlTextReader

XmlReaderSample1

button1_Click

SampleBase2

using MSXML2;

на

using System.Xml;

Мы должны это сделать, поскольку используем теперь не MSXML 3.0, а пространство имен

System.Xml

listBox1_SelectedIndexChanged

private DOMDocument30 doc;

protected void button1_Click(object sender, System.EventArgs e) {

 // Измените этот путь доступа, чтобы найти books.xml

 string fileName = "..\\..\\..\\books.xml";

 // Создать новый объект TextReader

 XmlTextReader tr = new XmlTextReader(fileName);

 // Прочитать узел за раз

 while(tr.Read()) {

  if (tr.NodeType == XmlNodeType.Text) listBox1.Items.Add(tr.Value);

 }

}

Это

XmlTextReader

fileName

XmlTextReader

fileName.XmlTextReader

XmlTextReader

tr.Read

Read

tr.NodeType

XmlNodeType

listbox

Существует несколько способов перемещения по документу. Как мы только что видели,

Read

HasValue

HasAttributes

ReadStartElement

XmlException

IsStartElement

Read

Методы

ReadString

ReadCharts

ReadString

ReadCharts

Метод

ReadElementString

ReadString

Name

Name

XmlReaderSample2

protected void button1_Click(object sender, System.EventArgs e) {

 // Использовать файловый поток для получения данных

 FileStream fs = new FileStream("..\\..\\..\\books.xml", FileMode.Open);

 XmlTextReader tr = new XmlTextReader(fs);

 while(!tr.EOF) {

  // если встретился тип элемента, проверить и загрузить его в окно списка

  if (tr.MoveToContent()==XmlNodeType.Element && tr.Name=="title") {

   listBox1.Items.Add(tr.ReadElementString());

 } else

  //иначе двигаться дальше

  tr.Read();

 }

}

В цикле

while

MoveToContent

XmlNodeType.Element

title

else

Read

ReadElementString

listbox

listbox

ReadElementString

Read

ReadElementString

Element

Если удалить

&& tr.Name=="title"

if

XmlException

<bookstore>

if

ReadElementString

XmlException

ReadElementString

LoadList

XmlTextReader

ReadElementString

XmlReaderSample3

protected void button1_Click(object sender, System.EventArgs e) {

 // использовать файловый поток для получения данных

 FileStream fs = new FileStream("..\\..\\..\\books.xml", FileMode.Open);

 XmlTextReader tr = new XmlTextReader(fs);

 while(!tr.EOF) {

  // если встретился тип элемента, проверить и загрузить его в окно списка

  if (tr.MoveToContent() == XmlNodeType.Element) {

   LoadList(tr);

  } else

   // иначе двигаться дальше

   tr.Read();

 }

}

private void LoadList(XmlReader reader) {

 try {

  listBox1.Items.Add(reader.ReadElementString());

 }

 //если инициировано исключение XmlException, игнорировать его.

 catch(XmlException er){}

}

Вот что должно появиться, когда код будет выполнен:

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

System.Xml

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

HasAttributes

true

false

AttributeCount

GetAttribute

MoveToFirstAttribute

MoveToNextAttribute

XmlReaderSample4

protected void button1_Click(object sender, System.EventArgs e) {

 // задаем путь доступа в соответствии со структурой путей доступа

 // к данным

 string fileName = "..\\..\\..\\books.xml";

 // Создать новый объект TextReader

 XmlTextReader tr = new XmlTextReader(filename);

 // Прочитать узел за раз

 while (tr.Read()) {

  // проверить, что это элемент NodeType

  if (tr.NodeType = XmlNodeType.Element) {

   // если это — элемент, то посмотрим атрибуты

   for(int i=0; i<tr.AttributeCount; i++) {

    listBox1.Items.Add(tr.GetAttribute(i));

   }

  }

 }

}

На этот раз мы ищем узлы элементов. Когда такой узел найден, в цикле просматриваются все атрибуты и с помощью метода

GetAttribute

listbox

Если нужно проверить документ XML, используйте класс

XmlValidatingReader

XmlTextReader

XmlReader

XmlValidatingReader

ValidationType

Schemes

SchemaType

ValidationType

Если свойство задано, то должен быть назначен обработчик событий

ValidationEventHandler

books.xml

booksVal.xml

<?xml version='1.0'?>

<!-- Этот файл представляет фрагмент базы данных учета запасов книжного склада -->

<bookstore xmlns="x-schema:books.xdr">

 <book genre="autobiography" publicationdate="1981" ISBN="1-861003-11-0">

  <title>The Autobiography of Benjamin Franklin</title>

  <author>

   <first-name>Benjamin</first-name>

   <last-name>Franklin</last-name>

  </author>

  <price>8.99</price>

 </book>

 <book genre="novel" publicationdate="1967" ISBN="0-201-63361-2">

  <title>The Confidence Man</title>

  <author>

   <first-name>Herman</first-name>

   <last-name>Melville</last-name>

  </author>

  <price>11.99</price>

 </book>

 <book genre="philosophy" publicationdate="1991" ISBN="1-861001-57-6">

  <title>The Gorgias</title>

  <author>

   <name>Plato</name>

  </author>

  <price>9.99</price>

 </book>

</bookstore>

Отметим, что элемент

bookstore

xmlns="x-schema:books.xdr"

<?xml version="1.0"?>

<Schema xmlns="urn:schemas-microsoft-com:xml-data" xmlns:dt="urn:schemas-microsoft-com:datatypes">

 <ElementType name="first-name" content="textOnly"/>

 <ElementType name="last-name" content="textOnly"/>

 <ElementType name="name" content="textOnly"/>

 <ElementType name="price" content="textOnly" dt:type="fixed.14.4"/>

 <ElementType name="author" content="eltOnly" order="one">

  <group order="seq">

   <element type="name"/>

  </group>

  <group order="seq">

   <element type="first-name"/>

   <element type="last-name"/>

  </group>

 </ElementType>

 <ElementType name="title" content="textOnlу" />

 <AttributeType name="genre" dt:type="string"/>

 <ElementType name="book" content="eltOnly">

  <attribute type="genre" required="yes"/>

  <element type="title"/>

  <element type="author"/>

  <element type="price"/>

 </ЕlementType>

 <ElementType name="bookstore" content="eltOnly">

  <element type="book"/>

 </ElementType>

</Schema>

Отметим, что имеются два атрибута в файле XML, которые не определены в схеме. Если посмотреть внимательно, то можно увидеть что в схеме нет атрибутов

publication-date

book

using System.Xml.Schema

XMLReaderSample5

protected void button1_Click (object sender, System.EventArgs e) {

 //измените это в соответствии с используемой структурой путей доступа.

 string filename = "..\\..\\..\\booksVal.xml";

 XmlTextReader tr = new XmlTextReader(filename);

 XmlValidatingReader trv=new XmlValidatingReader(tr);

 // Задать тип проверки

 trv.ValidationType=ValidationType.xdr;

 // Добавить обработчик события проверки

 trv.ValidationEventHandler += new ValidationEventHandler(this.ValidationEvent);

 // Считываем узел за раз

 while(trv.Read()) {

  if (trv.NodeType == XmlNodeType.Text) listBox1.Items.Add(trv.Value);

 }

}

public void ValidationEvent(object sender, ValidationEventArgs args) {

 MessageBox.Show(args.Message);

}

Мы создаем

XmlTextReader

XmlValidationReader

XmlValidationReader trv

XmlTextReader

ValidationType

ValidationEventHandler

ValidationEvent

MessageBox

MessageBox

ValdationEvent

В отличие от некоторых синтаксических анализаторов

XmlValidationReader

Свойство

Schemas

XmlValidationReader

XmlSchemaCollection

System.Xml.Schema

XmlSchemaCollection

Add

XmlSchema

XmlSchemaCollection

string

string

string

XmlReader

Класс

XmlTextWriter

TextWriter

XmlTextReader

XmlTextWriter

DataTypeNamespace

urn:schemas-microsoft-com:datatypes

TimeSpan

Приведем простой пример, чтобы увидеть, как может использоваться класс

TextWriter

XMLWriterSample1

private void button1_Click(object sender, System.EventArgs e) {

 // измените в соответствии с используемой структурой путей доступа

 string fileName="..\\..\\..\\booknew.xml";

 //создайте XmlTextWriter

 XmlTextWriter tw=new XmlTextWriter(fileName, null);

 // задайте форматирование с отступом

 tw.Formatting=Formatting.Indented;

 tw.WriteStartDocument();

 //Начать создание элементов и атрибутов

 tw.WriteStartElement("book");

 tw.WriteAttributeString("genre", "Mystery");

 tw.WriteAttributeString("publicationdate", "2001");

 tw.WriteAttributeString("ISBN", "123456789");

 tw.WriteElementString("title", "Case of the Missing Cookie");

 tw.WriteStartElement("author");

 tw.WriteElementString("name", "Cookie Monster");

 tw.WriteEndElement();

 tw.WriteElementString("price", "9.99");

 tw.WriteEndElement();

 tw.WriteEndDocument();

 // очистить

 tw.Flush();

 tw.Close();

}

Создадим новый файл

booknew.xml

XmlTextWriter

XmlTextWriter

FileStream

TextWriter

Indenting

WriteStartDocument()

book

genre

publicationdate

ISBN

title

author

author

name

После нажатия на кнопку будет создан следующий файл

booknew.xml

<?xml version="1 .0"?>

<book genre= "Mystery" publicationdate="2001" ISBN="123456789">

 <title>Case of the Missing Cookie</title>

 <author>

  <name>Cookie Monster</name>

 </author>

 <price>9,99</price>

</book>

Так же как в документе XML, здесь имеются начальный метод и конечный метод (

WriteStartElement

WriteEndElement

name

authors

WriteStartElement

WriteEndElement

В дополнение к

WriteElementString

WriteAtributeString

WriteCDate

CDate (<!CDATE[...]]>)

ReadChars

WriteChar

Чтение и запись XML с помощью классов, основанных на

XMLReader

System.Xml

XmlDocument

XmlNode

Реализация объектной модели документа (DOM, Document Object Model) в .NET поддерживает спецификации W3C DOM Level 1 и Core DOM Level 2. DOM реализуется с помощью класса

XmlNode

XmlNode

XmlNodeList

XmlNodeList

XmlNode

Как можно видеть .NET делает доступным класс, соответствующий почти любому типу XML. Мы не будем рассматривать каждый класс подробно, но разберем несколько примеров. Вот как выглядит диаграмма наследования:

Первый пример будет создавать объект

XmlDocument

title

XmlReader

XmlNode

DOMSample1

private void button1_Click(object sender. System.EventArgs e) {

 // doc объявлен на уровне модуля

 // изменить путь доступа в соответствии со структурой путей доступа

 doc.Load("..\\..\\..\\books.xml")

 // получить только те узлы, которые нужны

 XmlNodeList nodeLst=doc.GetElementsByTagName("title");

 // итерации по списку XmlNodeList

 foreach(XmlNode node in nodeLst) listBox1.Items.Add(node, InnerText);

}

Обратите внимание, что мы добавили следующее объявление на уровне модуля:

private XmlDocument doc=new XmlDocument();

Если бы это было все, что нужно делать, то использование

XmlReader

XmlDocument

DOMSample2

private void button1_Click(object sender, System.EventArgs e) {

 //doc объявлен на уровне модуля

 // измените путь доступа в соответствии со структурой путей доступа

 doc.Load("..\\..\\..\\books.xml");

 // получить только те узлы, которые хотим XmlNodeList

 nodeLst=doc.GetElementsByTagName("title");

 // итерации через список XmlNodeList

 foreach(XmlNode node in nodeLst) listBox1.Items.Add(node.InnerText);

}

private void listBox1_SelectedIndexChanged(object sender, System.EventArgs e) {

 // создать строку поиска XPath

 string srch="bookstore/book[title='" + listBox1.SelectedItem.ToString() + "']";

 // поиск дополнительных данных

 XmlNode foundNode=doc.SelectSingleNode(srch);

 if (foundNode!=null) MessageBox.Show(foundNode.InnerText);

 else MessageBox.Show("Not found");

}

В этом примере

listbox

books.xml

SelectedIndexChange

InitializeComponent

listbox

SelectSingleNode

doc

book

listbox

Небольшой комментарий в отношении метода

SelectSingleNode

XPath

XmlDocument

SelectSingleNode

SelectNodes

XmlNode

XmlDocument

SelectSingleNode

XmlNode

SelectNodes

XmlNodeList

System.Xml.XPath

XPath

Ранее рассматривался пример

XmlTextWriter

XmlDocument

button1_Click

DOMSample3

private void button1_Click(object sender, System.EventArgs e) {

 // изменить путь доступа, как требуется существующей структурой

 doc.Load("..\\..\\..\\books.xml");

 // создать новый элемент 'book'

 XmlElement newBook=doc.CreateElement("book");

 // задать некоторые атрибуты

 newBook.SetAttribute("genre", "Mystery");

 newBook.SetAttribute("publicationdate", "2001");

 newBook.SetAttricute("ISBN", "123456789");

 // создать новый элемент 'title'

 XmlElement newTitle=doc.CreateElement("title");

 newTitle.InnerText="Case of the Missing cookie";

 newBook.AppendChild(newTitle);

 // создать новый элемент author

 XmlElement newAuthor=doc.CreateElement("author");

 newBook.AppendChild(newAuthor);

 // создать новый элемент name

 XmlElement newName=doc.CreateElement("name");

 newName.InnerText="С. Monster";

 newAuthor.AppendChild(newName);

 // создать новый элемент price

 XmlElement newPrice=doc.CreateElement("price");

 newPrice.innerText="9.95";

 newBook.AppendChild(newPrice);

 // добавить к текущему документу

 doc.DocumenElement.AppendChild(newBook);

 // записать doc на диск

 XmlTextWriter tr=new XmlTextWriter("..\\..\\..\\booksEdit.xml", null);

 tr.Formatting=Formatting.Indented;

 doc.WriteContentTo(tr);

 tr.Close();

 // загрузить listBox1 со всеми заголовками, включая новый

 XmlNodeList nodeLst=doc.GetElementsByTagName("title");

 foreach(XmlNode node in nodeLst) listBox1.Items.Add(node.InnerText);

}

private void listBox1_SelectedIndexChanged(object sender, System.EventArgs e) {

 string srch="bookstore/book[title='" + listBox1.SelectedItem.ToString() + "']";

 XmlNode foundNode=doc.SelectSingleNode(srch);

 if (foundNode!=null) MessageBox.Show(foundNode.InnerText);

 else MessageBox.Show("Not found");

}

При выполнении этого кода будет получена функциональность предыдущего примера, но в окне списка появилась одна дополнительная книга "The Case of Missing Cookie". Щелчок мыши на заголовке этой книги приведет к выводу такой же информации, как и для других книг. Анализируя код, можно увидеть, что это достаточно простой процесс. Прежде всего создается новый элемент

book

XmlElement newBook = doc.CreateElement("book);

Метод

CreateElement

prefix

lоcalname

namespace

newBook.setAttribute("genre", "Mystery");

newBook.SetAttribute("publicationdate", "2001");

newBook.SetAttribute("ISBN", "123456789");

Напомним, что класс

XmlAttribute

XmlNode

XmlNode

Теперь, когда атрибуты созданы и необходимо добавить другие элементы книги:

XmlElement newTitle=doc.CreateElement("title");

newTitle.InnerText="Case of the Missing Cookie";

newBook.AppendChild(newTitle);

Здесь снова создается новый объект на основе

XmlElement (newTitle)

InnerText

book

book

name

author

Наконец, мы добавляем элемент

newBook

doc.DocumentElement

book

XmlWriter

XmlTextWriter

WriteContentTo

Close

XmlTextWriter

WriteContentTo

WriteTo

XmlTextWriter

WriteContentTo

XmlTextWriter

WriteTo

doc

XmlDocument

Save

Save

Stream

TextWriter

XmlWriter

Если нужно создать документ с самого начала, можно использовать класс

XmlTextWriter

XmlDocument

XmlTextWriter

XmlDocument

DOMSample4

private void button1_Click(object sender, System.EventArgs e) {

 // создать раздел объявлений

 XmlDeclaration newDoc=doc.CreateXmlDeclaration("1.0", null, null);

 doc.AppendChild(newDoc);

 // создать новый корневой элемент

 XmlElement newRoot=doc.CreateElement("newBookstore");

 doc.AppendChild(newRoot);

 // создать новый элемент 'book'

 XmlElement newBook=doc.CreateElement("book");

 // создать и задать атрибуты элемента "book"

 newBook.SetAttribute("genre","Mystery");

 newBook.SetAttribute("publicationdate", "2001");

 newBook.SetAttribute("ISBN", "123456789");

 // создать элемент 'title'

 XmlElement newTitle=doc.CreateElement("title");

 newTitle.InnerText="Case of the Missing Cookie";

 newBook.AppendChild(newTitle);

 // создать элемент author

 XmlElement newAuthor=doc.CreateElement("author");

 newBook.AppendChild(newAuthor);

 // создать элемент name

 XmlElement newName=doc.CreateElement("name");

 newName.InnerText="C. Monster";

 newAuthor.AppendChild(newName);

 // создать элемент price

 XmlElement newPrice=doc.CreateElement("price");

 newPrice.InnerText="9.95";

 newBook.AppendChild(newPrice);

 // добавить элемент 'book' к doc

 doc.DocumentElement.AppendChild(newBook);

 // записать на диск Note новое имя файла booksEdit.xml

 XmlTextWriter tr=new XmlTextWriter("..\\..\\..\\booksEdit.xml", null);

 tr.Formatting=Formatting.Indented; doc.WriteContentTo(tr);

 tr.Close();

 // загрузить заголовок в окно списка

 XmlNodeList nodeLst=doc.GetElementsByTagName("title");

 foreach(XmlNode node in nodeLst) listBox1.Items.Add(node.InnerText);

}

private void listBox1_SelectedIndexChanged(object sender, System.EventArgs e) {

 String srch="newBookstore/book[title='"+ listBox1.SelectedItem.ToString() + "']";

 XmlNode foundNode=doc.SelectSingleNode(srch);

 if (foundNode!=null) MessageBox.Show(foundNode.InnerText);

 else MessageBox.Show("Not found");

}

Заметим, что изменились только две начальные строки. Прежде чем сделать

doc.Load

XmlDeclaration newDoc=doc.CreateXmlDeclaration("1.0", null, null);

doc.AppendChild(newDoc);

XmlElement newRoot=doc.CreateElement("newBookstore");

doc.AppendChild(newRoot);

Сначала создается новый объект

XmlDeclaration

"1.0"

null

UTF-8

standalone

yes

no

System.Text.Encoding

null

Следующим создаваемым элементом станет

DocumentElement

newBookstore

booksEdit.xml

<?xml version="1.0"?>

<newBookstore>

 <book genre="Mystery" publicationdate="2001" ISBN="123456789">

  <title>Case of the Missing Cookie</title>

  <author>

   <name>C. Monster</name>

  </author>

  <price>9.95</price>

 </book>

</newBookstore>

Мы не рассмотрели всех особенностей класса

XmlDocument

XmlDocument

XmlReader

XmlDocument

XmlNode

Мы рассмотрим

XPath

XslTransform

XPath

System.Xml.XPath

XslTransform

System.Xml.Xsl

XPath

XPathNavigator

XSLTransform

XPath

System.Xsl

Пространство имен

XPath

XPath

XPath

XPathNavigator

XmlDocument

XmlDataDocument

XPathDocument

XmlDocument

XmlDataDocument

XPathDocument

XPathNavigator

XPath

XPathDocument

XmlDocument

TextReader

XmlReader

Stream

Загрузим документ

books.xml

System.Xml.Xsl

System.Xml.XPath

using System.Xml.XPath;

using System.Xml.Xsl;

Для данного примера воспользуемся файлом

bookspath.xml

books.xml

XPathXSLSample1

private void button1_Click(object sender, System.EventArgs e) {

 // изменить в соответствии с используемой структурой путей доступа

 XPathDocument doc=new XPathDocument("..\\..\\..\\booksxpath.xml");

 // создать XPathNavigator

 XPathNavigator nav=((IXPathNavigable)doc).CreateNavigator();

 // создать XPathNodeIterator узлов книг

 // который имеют значение атрибута genre, совпадающее с novel

 XPathNodeIterator iter=nav.Select("/bookstore/book[@genre='novel']");

 while(iter.MoveNext()) {

  LoadBook(iter.Current);

 }

}

private void LoadBook(XPathNavigator lstNav) {

 // Нам передали XPathNavigator определенного узла book,

 // мы выберем всех прямых потомков и

 // загрузим окно списка с именами и значениями

 XPathNodeIterator iterBook=lstNav.SelectDescendants(XPathNodeType.Element, false);

 while(iterBook.MoveNext())

listBox1.Items.Add(iterBook.Current.Name + ": " + iterBook.Current.Value);

}

Здесь сначала создается

XPathDocument

XPathNavigator

XPathNavigator nav=((IXPathNavigable)doc).CreateNavigator();

Отметим, что здесь происходит преобразование типа интерфейса

IXPathNavigable

XPathNavigator

CreateNavigator

XPathNavigator

Этот пример показывает, как применяются методы

Select

novel

genre

MoveNext()

novels

Для загрузки данных в

listbox

XPathNodeIterator.Current

XPathNavigator

XPathNodeIterator

XPathNavigator

book

LoadBook

XPathNodeIterator

SelectDescendants

XPathNodeIterator

book

LoadBook

MoveNext()

XPathNodeIterator

XPathNavigator

Существует также несколько методов

Select

Select

XPathNodeIterator

XPathNodeIterator

NodeList

NodeSet

XPath

□ 

Clone

□ 

Count

XPathNodeIterator

□ 

Current

XPathNavigator

□ 

CurrentPosition

□ 

MoveNext

Xpath

XPathNodeIterator

Можно использовать также существующие методы

SelectAncestors

SelectChildren

XPathNodelterator

Select

XPath

XPathNodeType

XPathNodeType.Element

Вот как выглядит экран после выполнения кода. Обратите внимание, что все перечисленные книги являются романами (novel).

Для добавления стоимости книг

XPathNavigator

Evaluate

Evaluate

XPath

XPathExpression

XPathExpression

XPathNodeIterator

XPathXSLSample2

private void button1_Click(object sender, System.EventArgs e) {

 //изменить в соответствии со структурой путей доступа

 XPathDocument doc=new XPathDocument("..\\..\\..\\booksxpath.XML");

 //создать XPathNavigator

 XPathNavigator nav=((IXPathNavigable)doc).CreateNavigator();

 //создать XPathNodeIterator узлов book,

 // которые имеют novel значением атрибута genre

 XPathNodeIterator iter=nav.Select("/bookstore/book[@genre="novel']");

 while(iter.MoveNext()) {

  LoadBook(iter.Current.Clone());

 }

 // добавим разделительную линию и вычислим сумму

 listBox1.Items.Add("========================");

 listBox1.Items.Add("Total Cost = "

  + nav.Evaluate("sum(/bookstore/book[@genre='novel']/price)"));

}

При этом вывод изменится следующим образом:

Пространство имен

System.Xml.Xsl

XslTransform

IXPathNavigable

XmlDocument

XmlDataDocument

XPathDocument

IXPathNavigable

XslTransform

В первом примере, который мы рассмотрим, берется документ

books.xml

XPathXSLSample3

using

using System.IO;

using System.Xml.Xsl;

using System.Xml.XPath;

Вот код, выполняющий преобразование:

private void button1_Click(object sender System.EventArgs e) {

 //создать новый XPathDocument

 XPathDocument doc=new XPathDocument("..\\..\\..\\booksxpath.XML");

 // создать новый XslTransForm

 XslTransform transForm=new XslTransform();

 transForm.Load("..\\..\\..\\books.xsl");

 // этот FileStream будет нашим выводом

 FileStream fs=new FileStream("..\\..\\..\\booklist.html", FileMode.Create);

 // Создать Navigator

 XPathNavigator nav=((IXPathNavigable)doc).CreateNavigator();

 // Выполнить преобразование. Файл вывода создается здесь.

 transForm.Transform(nav, null, fs);

}

Сделать это преобразование проще почти невозможно. Сначала создается объект на основе

XPathDocument

XslTransform

bookspath.xml

doc

books.xsl

transForm

FileStream

Если бы это было приложение ASP.NET, мы использовали бы объект

TextWriter

HttpResponse

XmlWriter

XPathDocument

XslTransform

XPathNavigator

doc

nav

stream

Transform

transForm

XslTransform

XsltArgumentList

XPathNavigator

IXPathNavigable

TextWriter

Stream

XmlWriter

Документ

books.xsl

<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">

 <xsl:template match="/">

  <html>

   <head>

    <title>Price List</title>

   </head>

   <body>

    <table>

     <xsl:apply-templates/>

    </table>

   </body>

  </html>

 </xsl:template>

 <xsl:template match="bookstore">

  <xsl:apply-templates select= "book"/>

 </xsl:template>

 <xsl:template match="book">

  <tr><td>

   <xsl:value-of select="title"/>

  </td><td>

   <xsl:value-of select="price"/>

  </td></tr>

 </xsl:template>

</xsl:stylesheet>

Ранее упоминался объект

XsltArgumentList

XPathXSLSample4

private void button1_Click(object sender, System.EventArgs e) {

 // новый XPathDocument

 XPathDocument doc=new XPathDocument("..\\..\\..\\booksxpath.xml");

 // новый XslTransform

 XslTransform transForm=new XslTransform();

 transForm.Load("..\\..\\..\\booksarg.xsl");

 // новый XmlTextWriter, так как мы создаем новый документ xml

 XmlWriter xw=new XmlTextWriter(..\\..\\..\\argSample.xml", null);

 // создать XslArgumentList и новый объект BookUtils

 XsltArgumentList argBook=new XsltArgumentList();

 BookUtils bu=new BookUtils();

 // это сообщает список аргументов BookUtils

 argBook.AddExtensionObject("urn:ProCSharp", bu);

 // новый XPathNavigator

 XPathNavigator nav=((IXPathNavigable)doc).CreateNavigator();

 // выполнить преобразование

 transForm.Transform(nav, argBook, xw);

 xw.Close();

}

// простой тестовый класс

public class BookUtils {

 public BookUtils() {}

 public string ShowText() {

  return "This came from the ShowText method!";

 }

}

Вывод преобразования (

argSample.xml

<?xml version="1.0"?>

<books>

 <discbook>

  <booktitle>The Autobiography of Benjamin Franklin</booktitle>

  <showtext>This came from the ShowText method!</showLext>

 </discbook>

 <discbook>

  <booktitle>The Confidence Man</booktitle>

  <showtext>This came from the ShowText method!</showtext>

 </discbook>

 <discbook>

  <booktitle>The Gorgias</booktitle>

  <showtext>This came from the ShowText method!</showtext>

 </discbook>

 <discbook>

  <booktitle>The Great Cookie Caper</booktitle>

  <showtext>This came from the ShowText method!</showtext>

 </discbook>

 <discbook>

  <booktitle>A Really Great Book</booktitle>

  <showtext>This came from the ShowText method!</showtext>

 </discbook>

</books>

Определим новый класс

BookUtils

"This came from the ShowText method!"

button1_Click

XPathDocument

XslTransform

XMLWriter

FileStream

XsltArgumentList argBook=new XsltArgumentList();

BookUtils bu=new BookUtils();

argBook.AddExtensionObject("urn:ProCSharp", bu);

Именно здесь создается

XsltArgumentList

BookUtils

AddExtensionObject

Transform

XsltArgumentList

argBook

XPathNavigator

XmlWriter

booksarg.xsl

<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:bookutil="urn:ProCSharp">

 <xsl:output method="xml" indent="yes"/>

 <xsl:template match="/">

  <xsl:element name="books">

   <xsl:apply-templates/>

  </xsl:element>

 </xsl:template>

 <xsl:template match="bookstore">

  <xsl:apply-templates select="book"/>

 </xsl:template>

 <xsl:template match="book">

  <xsl:element name="discbook">

   <xsl:element name="booktitle">

    <xsl:value-of select="title"/>

   </xsl:element>

   <xsl:element name="showtext">

    <xsl:value-of select="bookUtil:ShowText()"/>

   </xsl:element>

  </xsl:element>

 </xsl:template>

</xsl:stylesheet>

Здесь имеются две важные строки. В начале добавляется пространство имен, которое создается при добавлении объекта к

XsltArgumentList

Иначе это можно было бы выполнить с помощью сценария XSLT. В таблицу стилей можно включить код C#, VB и JavaScript. Большим достоинством этого является то, что в отличие от текущих реализаций, сценарий компилируется при вызове

Transform.Load

bookscript.xsl

<xsl:stylesheet version="1.0" xmlns:Xsl="http://www.w3.org/1999/XSL/Transform" xmlns:msxsl="urn:schemas-microsoft-com:xslt" xmlns:user="http://wrox.com">

 <msxsl:script language="C#" implements-prefix="user">

  string ShowText() {

   return "This came from the ShowText method!";

  }

 </msxsl:script>

 <xsl:output method="xml" indent="yes"/>

 <xsl:template match="/">

  <xsl:element name="books">

   <xsl:apply-templates/>

  </xsl:element>

 </xsl:template>

 <xsl:template match="bookstore">

  <xsl:apply-templates select="book"/>

 </xsl:template>

 <xsl:template match="book">

  <xsl:element name="discbook">

   <xsl:element name="booktitle">

    <xsl:value-of select="title"/>

   </xsl:element>

   <xsl:element name="showtext">

    <xsl:value-of select="user:ShowText()"/>

   </xsl:element>

  </xsl:element>

 </xsl:template>

</xsl:stylesheet>

Изменения включают задание пространства имен сценариев, добавление кода (который скопирован из VS.NET IDE) и выполнение вызова в таблице стилей. Вывод выглядит так же, как и в предыдущем примере.

Ключевой момент, о котором необходимо помнить при выполнении преобразований, состоит в том, чтобы не забыть использовать подходящее хранилище;

XPathDocument

XmlDataDocument

XmlDocument

XML является средством, которое связывает ADO.NET с остальным миром. ADO.NET был создан для работы внутри среды XML. XML используется для преобразования данных в и из хранилища данных в приложение или страницу Web. Так как ADO.NET использует XML в качестве транспорта, то данными можно обмениваться с приложениями и системами, которые даже не знают об ADO.NET. Пока обрабатывается XML, они могут совместно использовать данные. ADO.NET может читать документы XML, возвращаемые из этих же приложений. В связи с важностью XML для ADO.NET, существует ряд полезных свойств ADO.NET, которые позволяют чтение и запись документов XML. Пространство имен XML содержит также классы, которые могут потреблять или утилизировать реляционные данные ADO.NET.

Первый пример, который будет рассмотрен, использует потоки ADO.NET и XML для извлечения данных из базы данных

Northwind

DataSet

XmlDocument

DataSet

using

using System.Data;

using System.Xml;

using System.Data.SqlClient;

using System.IO;

Также для примеров ADO в формы добавлены

DataGrid

DataSet

listbox

ADOSample1

private void button1_Click(object sender, System.EventArgs e) {

 // создать множество данных DataSet

 DataSet ds=new DataSet("XMLProducts");

 // соединиться с базой данных northwind и

 //выбрать все строки из таблицы продуктов

 //убедитесь, что имя пользователя соответствует версии SqlServer

 SqlConnection conn=

  new SqlConnection(@"server=GLYNNJ_CS\NetSDK;uid=sa;pwd=;database=northwind");

 SqlDataAdapter da=new SqDataAdapter("select * from products", conn);

После создания

SqlDataAdapter

da

DataSet

ds

MemoryStream

StreamReader

StreamWriter

StreamReader

StreamWriter

MemoryStream

 MemoryStream memStrm=new MemoryStream();

 StreamReader strmRead=new StreamReader(memStrm);

 StreamWriter strmWrite=new StreamWriter(memStrm);

Мы будем использовать

MemoryStream

Stream

FileStream

DataSet

DataGrid

DataSet

DataGrid

 da.Fill(ds, "products");

 // загрузка данных в DataGrid

 dataGrid1.DataSource=ds;

 dataGrid1.DataMember="products";

На следующем шаге генерируется XML. Вызывается метод

WriteXml

DataSet

WriteXml

WriteXml

mode

mode

XmlWriteMode

DiffGram

IgnoreSchema

WriteSchema

DiffGram

IgnoreSchema

WriteXml

inline

WriteSchema

WriteXmlSchema

XmlWriter

TextWriter

 ds.WriteXml(strmWrite, XmlWriteMode.IgnoreSchema);

 memStrm.Seek(0, SeekOrigin, Begin);

 // читаем из потока в памяти в объект XmlDocument

 doc.load(strmRead);

 // получить все элементы продуктов

 XmlNodeList nodeLst=doc.GetElementsByTagName("ProductName");

 // загрузить их в окно списка

 foreach(XmlNode nd in nodeLst) listBox1.Items.Add(nd.InnerText);

}

private void listBox1_SelectedIndexChanged(object sender, System.EventArgs e) {

 // при щелчке в окне списка

 // появляется окно сообщения с ценой изделия

 string srch=

  "XmlProducts/products[ProductName= " + '"' + listBox1.SelectedItem.ToString() + "]";

 XmlNode foundNode=doc.SelectSingleNode(srch);

 if (foundNode!=null)

  MessageBox.Show(foundNode.SelectSingleNode("UnitPrice").InnerText);

 else MessageBox.Show("Not found");

}

На следующем экране можно видеть данные в списке, а также в таблице данных:

Если желательно сохранить документ XML на диске, то нужно сделать примерно следующее:

string file = "с:\\test\\product.xml";

ds.WriteXml(file);

Это даст нам правильно сформированный документ XML на диске, который можно прочитать посредством другого потока, с помощью

DataSet

XmlMode

XmlDocument

XmlDocument.Load

Когда

XmlDocument

listbox

XPath

listBox1_SelectedIndexChanged

InnerText

XPath

SelectSingleNode

UnitPrice

listbox

MessageBox

UnitPrise

Следующий пример будет упрощать процесс, удаляя три потока и используя некоторые возможности ADO, встроенные в пространство имен XML. Нам понадобится изменить строку кода на уровне модуля:

private XmlDocument doc=new XmlDocument();

на:

private XmlDataDocument doc;

Это нужно сделать, так как мы не собираемся использовать

XmlDataDocument

ADOSample2

private void button1_Click(object sender, System.EventArgs e) {

 // создать множество данных (DataSet)

 DataSet ds=new DataSet("XMLProducts");

 // соединиться с базой данных northwind и

 //выбрать все строки из таблицы products

 //выполнить изменения в строке подключения с учетом имени пользователя и имени сервера

 SqlConnection conn=

  new SqlConnection(@"server=GLYNNJ_CS\NetSDK;uid=sa;pwd=;database=northwind");

 SqlDataAdapter da=new SqlDataAdapter("select * from products", conn);

 // заполнить множество данных

 da.Fill(ds, "products");

 // загрузить данные в сетку

 dataGrid1.DataSource=ds;

 dataGrid1.DataMember="products";

 doc=new XmlDataDocument(ds);

 // извлечь все элементы продуктов

 XmlNodeList nodeLst=doc.GetElementsByTagName("ProductName");

 // загрузить их в окно списка

 // здесь используется цикл for

 for(int ctr=0; ctr<nodeLst.Count; ctr++) listBox1.Items.Add(nodeLst[ctr].InnerText);

}

Как можно видеть, код для загрузки

DataSet

XmlDocument

XmlDataDocument

DataSet

XmlDataDocument

XmlDocument

XmlDocument

XmlDataDocument

XmlDataDocument

XmlDataDocument doc=new XmlDataDocument(ds);

Он передает в качестве параметра созданный объект

DataSet

ds

Load

DataSet

DataSet

XmlDataDocument

DataSet

DataSet

NewDataSet

DataTables

DataSet

XmlDataDocument

DataSet.Fill

ds.WriteXml("с:\\test\\sample.xml" , XmlWriteMode, WriteSchema);

…создается следующий XML. Отметим, что мы включили в документ схему XSD. Если нежелательно, чтобы схема включалась в файл, то можно передать член перечисления

XmlWriteMode.IgnoreSchema

<?xml version="1.0" standalone="yes"?>

<XMLProducts>

 <xsd:schema id="XMLProducts" targetNamespace="" xmlns="" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">

  <xsd:element name="XMLProducts" msdata:IsDataSet="true">

   <xsd:complexType>

    <xsd:choice maxOccurs="unbounded">

     <xsd:element name="products">

      <xsd:complexType>

       <xsd:sequence>

        <xsd:element name="ProductID" type="xsd:int" minOccurs="0" />

        <xsd:element name="ProductName" type="xsd:string" minOccurs="0" />

        <xsd:element name="SupplierID" type="xsd:int" minOccurs ="0" />

        <xsd:element name="CategoryID" type="xsd:int" minOccurs="0" />

        <xsd:element name="QuantityPerUnit" type="xsd:string" minOccurs="0" />

        <xsd:element name="UnitPrice" type="xsd:decimal" minOccurs="0" />

        <xsd:element name="UnitsInStock" type="xsd:short" minOccurs="0" />

        <xsd:element name="UnitsOnOrder" type="xsd:short" minOccurs="0" />

        <xsd:element name="ReorderLevel" type="xsd:short" minOccurs="0" />

        <xsd:element name="Discontinued" type="xsd:boolean" minOccurs="0" />

       </xsd:sequence>

      </xsd:сomplexType>

     </xsd:element>

    </xsd:choice>

   </xsd:complexType>

  </xsd:element>

 </xsd:schema>

 <products>

  <ProductID>1</ProductID>

  <ProductName>Chai</ProductName>

  <SupplierID>1</SupplierID>

  <CategoryID>1</CategoryID>

  <QuantityPerUnit>10 boxes x 20 bags</QuantityPerUnit>

  <UnitPrice>18</UnitPrice>

  <UnitsInStock>39</UnitsInStock>

  <UnitsOnOrder>0</UnitsOnOrder>

  <ReorderLevel>10</ReorderLevel>

  <Discontinued>false</Discontinued>

 </products>

 <products>

  <ProductID>2</ProductID>

  <ProductName>Chang</ProductName>

  <SupplierID>1</SupplierID>

  <CategoryID>1</CategoryID>

  <QuantityPerUnit>24 - 12 oz bottles</QuantityPerUnit>

  <Unitprice>19</UnitPrice>

  <UnitsInStock>17</UnitsInStock>

  <UnitsOnOrder>40</UnitsOnOrder>

  <ReorderLevel>25</ReorderLevel>

  <Discontinued>false</Discontinued>

 </products>

</XMLProducts>

Показаны только два первых продукта. Реальный файл XML будет содержать все продукты из таблицы

Products

Northwind

Это выглядит достаточно просто для одной таблицы, но что будет для реляционных данных, таких как несколько

DataTables

Relations

DataSet

ADOSample3

private void button1_Click(object sender, System.EventArgs e) {

 //создать множество данных (DataSet)

 DataSet ds=new DataSet("XMLProducts");

 // соединиться с базой данных northwind и

 //выбрать все строки из таблицы products и таблицы suppliers

 //проверьте, что строка соединения соответствует конфигурации сервера

 SqlConnection conn=

  new SqlConnection(@"server=GLYNNJ_CS\NetSDK;uid=sa;pwd=;database=northwind");

 SqlDataAdapter daProd=new SqlDataAdapter("select * from products", conn);

 SqlDataAdapter daSup=new SqlDataAdapter("select * from suppliers", conn);

 //Заполнить DataSet из обоих SqlAdapters

 daProd.Fill(ds, "products");

 daSup.Fill(ds, "suppliers");

 //Добавить отношение

 ds.Relations.Add(ds.Tables["suppliers"].Columns["SupplierId"],

  ds.Tables["products"].Columns["SupplierId"]);

 //Записать Xml в файл, чтобы можно было просмотреть его позже

 ds.WriteXml("..\\..\\..\\SuppProd.xml", XmlWriteMode.WriteSchema);

 //загрузить данные в таблицу

 dataGrid1.DataSource=ds;

 dataGrid1.DataMember="suppliers";

 //создать XmlDataDocument

 doc=new XmlDataDocument(ds);

 //Выбрать элементы productname и загрузить их в таблицу

 XmlNodeList nodeLst=doc.SelectNodes("//ProductName");

 foreach(XmlNode nd in nodeLst) listBox1.Items.Add(nd.InnerXml);

}

В этом примере создаются два объекта

DataTables

DataSet

XMLProducts

Products

Suppliers

Suppliers

Products

SupplierId

DataSet

Делая такой же вызов метода

WriteXml

SuppProd.xml

<?xml version="1.0" standalone="yes"?>

<XMLProducts>

 <xsd:schema id="XMLProducts" targetNamespace="" xmlns="" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">

  <xsd:element name="XMLProducts" msdata:IsDataSet="true">

   <xsd:complexType>

    <xsd:choice maxOccurs="unbounded">

     <xsd:element name="products">

      <xsd:complexType>

       <xsd:sequence>

        <xsd:element name="Product ID" type="xsd:int" minOccurs="0" />

        <xsd:element name="ProductName" type="xsd:string" minOccurs="0" />

        <xsd:element name="SupplierID" type="xsd:int" minOccurs="0" />

        <xsd:element name="CategoryID" type="xsd:int" minOccurs="0" />

        <xsd:element name="QuantityPerUnit" type="xsd:string" minOccurs="0" />

        <xsd:element name="UnitPrice" type="xsd:decimal" minOccurs="0" />

        <xsd:element name="UnitsInStock" type="xsd:short" minOccurs="0" />

        <xsd:element name="UnitsOnOrder" type="xsd:short" minOccurs="0" />

        <xsd:element name="ReorderLevel" type="xsd:short" minOccurs="0" />

        <xsd:element name="Discontinued" type="xsd:boolean" minOccurs="0" />

       </xsd:sequence>

      </xsd:complexType>

     </xsd:element>

     <xsd:element name="suppliers">

      <xsd:complexType>

       <xsd:sequence>

        <xsd:element name="SupplierID" type="xsd:int" minOccurs="0" />

        <xsd:element name="CompanyName" type="xsd:string" minOccurs="0" />

        <xsd:element name="ContactName" type="xsd:string" minOccurs="0" />

        <xsd:element name="ContactTitle" type="xsd:string" minOccurs="0" />

        <xsd:element name="Address" type="xsd:string" minOccurs="0" />

        <xsd:element name="City" type="xsd:string" minOccurs="0" />

        <xsd:element name="Region" type="xsd:string" minOccurs="0" />

        <xsd:element name="PostalCode" type="xsd:string" minOccurs="0" />

        <xsd:element name="Country" type="xsd:string" minOccurs="0" />

        <xsd:element name="Phone" type="xsd:string" minOccurs="0" />

        <xsd:element name="Fax" type="xsd:string" minOccurs="0" />

        <xsd:element name="HomePage" type="xsd:string" minOccurs="0" />

       </xsd:sequence>

      </xsd:complexType>

     </xsd:element>

    </xsd:choice>

   </xsd:complexType>

   <xsd:unique name="Constraint1">

    <xsd:selector xpath=".//suppliers" />

    <xsd:field xpath="SupplierID" />

   </xsd:unique>

   <xsd:keyref name="Relation1" refer="Constraint1">

    <xsd:selector xpath=".//products" />

    <xsd:field xpath="SupplierID" />

   </xsd:keyref>

  </xsd:elements>

 </xsd:schema>

 <products>

  <ProductID>1</ProductID>

  <ProductName>Chai</ProductName>

  <SupplierID>1</SupplierID>

  <CategoryID>1</CategoryID>

  <QuantityPerUnit>10 boxes x 20 bags</QuantityPerUnit>

  <UnitPrice>18</UnitPrice>

  <UnitsInStock>39</UnitsInStock>

  <UnitsOnOrder>0</UnitsOnOrder>

  <ReorderLevel>10</ReorderLevel>

  <Discontinued>false</Discontinued>

 </products>

 <products>

  <ProductID>2</ProductID>

  <ProductName>Chang</ProductName>

  <SupplierID>1</SupplierID>

  <CategoryID>1</CategoryID>

  <QuantityPerUnit>24 - 12 oz bottles</QuantityPerUnit>

  <UnitPrice>19</UnitPrice>

  <UnitsInStock>17</UnitsInStock>

  <UnitsOnOrder>40<UnitsOnOrder>

  <ReorderLevel>25</ReorderLevel>

  <Discontinued>false</Discontinued>

 </products>

 <suppliers>

  <SupplierID>1</SupplierID>

  <CompanyName>Exotiс Liquids</CompanyName>

  <ContactName>Charlotte Cooper</ContactName>

  <ContactTitle>Purchasing Manager</ContactTitle>

  <Address>49 Gilbert St.</Address>

  <City>London</City>

  <PostalCode>EC1 4SD</PostalCode>

  <Country>UK</Country>

  <Phone>(171) 555-2222</Phone>

 </suppliers>

 <suppliers>

  <Supplier ID>2</SupplierID>

  <CompanyName>New Orleans Cajun Delights</CompanyName>

  <ContactName>Shelley Burke</ContactName>

  <ContactTitle>Order Adminisirator</ContactTitle>

  <Address>P.O. Box 78934</Address>

  <City>New Orleans</City>

  <Region>LA</Region>

  <PostalCode>70117</PostalCode>

  <Country>USA</Country>

  <Phone>(100) 555-4822</Phone>

  <HomePage>#CAJUN.HTM#</HomePage>

 </suppliers>

</XMLProducts>

Эта схема включает в себя обе таблицы данных

DataTables

DataSet

XmlWriteMode

Предположим что имеется документ XML, который нужно поместить в

DataSet

DataGrid

ADOSample4

private void button1_Click(object sender, System.EventArgs e) {

 // создать новое множество данных (DataSet)

 DataSet ds=new DataSet("XMLProducts");

 //считать документ Xml в Dataset

 ds.ReadXml("..\\..\\..\\prod.xml");

 //загрузить данные в таблицу

 detaGrid1.DataSource=ds;

 dataGrid1.DataMember="products";

 //создать новый XmlDataDocument

 doc=new XmlDataDocument(ds);

 //загрузить имена продуктов в окно списка

 XmlNodeList nodeLst=doc.SelectNodes("//ProductName");

 foreach(XmlNode nd in nodeLst) listBox1.Items.Add(nd.InnerXml);

}

Действительно, просто. Создается экземпляр нового объекта

DataSet

ReadXml

DataTable

DataSet

WriteXml

ReadXml

XmlReadMode

XmlReadMode

Существует также метод

ReadSchema

ReadSchema

Stream, объект

TextReader

XmlReader

Чтобы показать, что таблицы данных будут созданы правильно, загрузим документ XML, который содержит таблицы

Products

Suppliers

listbox

DataTable

DataColumn

Northwind

ADOSample5

private void button1_Click(object sender, System.EventArgs e) {

 // создать DataSet

 DataSet ds=new DataSet("XMLProducts");

 // считать документ xml

 ds.ReadXml("..\\..\\..\\SuppProd.xml");

 // загрузить данные в сетку

 dataGrid1.DataSource=ds;

 dataGrid1.DataMember="products";

 // загрузить в listbox информацию о таблицах, столбцах и типах данных

 foreach(DataTable dt in ds.Tables) {

  listBox1.Items.Add(dt.TableName);

  foreach(DataColumn col in dt.Columns) {

   listBox1.Items.Add('\t' + col.ColumnName + " - " + col.DataType.FullName);

  }

 }

}

Отметим добавление двух циклов

foreach

DataSet

foreach

DataTable

listbox

Посмотрев на

listbox

DataTables

Кроме того, можно заметить, что последние два примера не преобразуют никаких данных в или из базы данных, таким образом, не определены

SqlDataAdapters

SqlConnections

System.Xml

DiffGram

DiffGram

Далее представлен код, показывающий, как

DiffGram

DataSet

DiffGram:pwd

ADOSample6

DataSet

ds

SqlConnection

conn

SqlDataAdapter

da

Products

DataTable

products

DataSet

private void button1_Click(object sender, System.EventArgs e) {

 // новый объект DataSet

 DataSet ds=new DataSet("XMLProducts");

 // Сделать соединение и загрузить строки продуктов

 SqlConnection conn=

  new SqlConnection(@"server=GLYNNJ_CS\NetSDK;uid=sa;pwd=;database=northwind");

 SqlDataAdapter da=new SqlDataAdapter("select * from products", conn);

 // заполнить DataSet

 da.Fill(ds, "products");

 // редактируем первую строку

 ds.Tables["products"].Rows[0]["ProductName"] = "NewProdName";

В следующем разделе мы сделаем следующие преобразования. Во-первых, изменим столбец

ProductName

NewProdName

DataTable

DataTable

 // добавить новую строку

 DataRow dr=ds.Tables["products"].NewRow();

 dr["ProductId"]=100;

 dr["CategoryId"]=2;

 dr["Discontinued"]=false;

 dr["ProductName"]="This is the new product";

 dr["QuantityPerUnit"]=12;

 dr["ReorderLevel"]=1;

 dr["SupplierId"]=12;

 dr["UnitPrice"]=23;

 dr["UnitsInStock"]=5;

 dr["UnitsOnOrder"]=0;

 Tables["products"].Rows.Add(dr);

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

WriteXmlSchema

DiffGram

WriteXml

XmlWriteMode.DiffGram

DiffGram

DiffGram

AcceptChanges

// записать схему

ds.WriteXmlSchema("..\\..\\..\\diffgram.xsd");

// создать DiffGram

ds.WriteXml("..\\..\\..\\diffgram.xml", XmlWriteMode.DiffGram);

ds.AcceptChanges();

// загрузить данные в сетку

dataGrid1.DataSource=ds;

dataGrid1.DataMember="products";

// новый объект XmlDataDocument

doc=new XmlDataDocument(ds);

// загрузить имена продуктов в список

XmlNodeList nodeLst=doc.SelectNodes("//ProductName");

foreach (XmlNode nd in nodeLst) listBox1.Items.Add(nd.InnerXml);

Чтобы вернуть данные в множество DataSet, можно сделать следующее:

DataSet dsNew = new DataSet();

dsNew.ReadXmlSchema("..\\..\\..\\diffgram.xsd");

dsNew.XmlRead("..\\..\\..\\diffgram.xml", XmlReadMode.DiffGram);

В этом примере создается новый объект множества данных

DataSet

dsNew

ReadXmlSchema

DataTable

DataTable

DiffGram

DiffGram

DataTable

ReadXml

DiffGram

diffgram.xml

<?xml version="1.0" standalone="yes"?>

 <diffgr:diffgram xmlns:msdata="urn:schemas-microsoft-com:xml-msdata" xmlns:diffgr="urn:schemas-microsoft-com:xml-diffgram-v1">

  <XMLProducts>

   <products diffgr:id="products1" msdata:rowOrder="0" diffgr:hasChanged="modified">

    <ProductID>1</ProduсtID>

    <ProductName>NewProdName</ProductName>

    <SupplierID>1</SupplierID>

    <CategoryID>1</CategoryID>

    <QuantityPerUnit>10 boxes x 20 bags</QuantityPerUnit>

    <UnitPrice>18</UnitPrice>

    <UnitsInStock>39</UnitsInStock>

    <UnitsOnOrder>0</UnitsOnOrder>

    <ReorderLevel>10</ReorderLevel>

    <Discontinued>false</Discontinued>

   </products>

   <products diffgr:id="products2" msdata:rowOrder="1">

    <ProductID>2</ProductID>

    <ProduсtName>Chang</ProductName>

    <SupplierID>1</SupplierID>

    <CategoryID>1</CategoryID>

    <QuantityPerUnit>24 - 12 oz bottles</QuantityPerUnit>

    <UnitPrice>19</UnitPrice>

    <UnitsInStock>17</UnitsInStock>

    <UnitsOnOrder>40</UnitsOnOrder>

    <ReorderLevel>25</ReorderLevel>

    <Discontinued>false</Discontinued>

   </products>

…

   <products diffgr:id="products78" msdata:rowOrder="77" diffgr:hasChanges="inserted">

    <ProductID>100</ProductID>

    <ProductName>This is a new product</ProductName>

    <SupplierID>12</SupplierID>

    <CategoryID>2</CategoryID>

    <QuantityPerUnit>12</QuantityPerUnit>

    <UnitPrice>23</UnitPrice>

    <UnitsInStock>5</UnitsInStock>

    <UnitsOnOrder>0</UnitsOnOrder>

    <ReorderLevel>1</ReorderLevel>

    <Discontinued>false</Discontinued>

   </products>

  </XMLProducts>

  <diffgr:before>

   <products diffgr:id="products1" msdata:rowOrder="0">

    <ProductID>1</ProductID>

    <ProductName>Chai </ProductName>

    <SupplierID>1</SupplierID>

    <CategoryID>1</CategoryID>

    <QuantityPerUnit>10 boxes x 20 bugs </QuantityPerUnit>

    <UnitPrice>18</UnitPrice>

    <UnitsInStock>39</UnitsInStock>

    <UnitsOnOrder>0</UnitsOnOrder>

    <ReorderLevel>10</ReorderLevel>

    <Discontinued>false</Discontinued>

   </products>

  </diffgr:before>

</diffgr:diffgram>

Заметим, каким образом повторяется каждая строка

DataTable

diffgr:id

<products>

diffgr

urn:schemas-microsoft-com:xml-diffgram-v1

diffgr:hasChanges

<diffgr:before>

<XMLProducts>

<products>

"before"

<diffgr:before>

После того как

DiffGram

DataTable

AcceptChanges

RejectChanges

DataRow.Item

DataRowVersion.Original

DataRowVersion.Current

DataTable

Сериализация является процессом сохранения объекта на диске. Другая часть приложения или даже другое приложение могут десериализовать объект и он будет в том же состоянии, в каком он был до сериализации. Платформа .NET содержит два способа выполнения сериализации. Рассмотрим пространство имен

System.Xml.Serialization

Как показывает имя, сериализация производится в формате XML. Это делается преобразованием открытых свойств объекта и открытых полей в элементы и/или атрибуты. Сериализатор XML не может преобразовать скрытые данные, а только открытые. Представляйте это как способ сохранения состояния объекта. Если необходимо сохранить скрытые данные, то используйте

BinaryFormatter

System.Runtime.Serialization.Formatters.Binary

□ Определить, должны ли данные быть атрибутом или элементом.

□ Определить пространство имен.

□ Изменить имя атрибута или элемента.

Вместе с возможностью сериализовать только открытые данные, невозможно сериализовать графы объектов (объекты, которые достижимы из сериализуемого объекта). Это не является серьезным ограничением. При тщательном проектировании классов этого легко можно избежать. Если необходимо иметь возможность сериализовать открытые и скрытые данные, а также граф объектов, содержащий множество вложенных объектов, то можно будет воспользоваться пространством имен

System.Runtime.Serialization.Formatters.Binary

Данные для сериализации могут быть примитивными типами данных, полями, массивами и XML, встроенным в форму объектов

XmlElement

XmlAttribute

На платформе .NET существует инструмент, помогающий создавать атрибуты,— это утилита

xsd.exe

□ Генерировать схему XML из файла схемы XDR

□ Генерировать схему XML из файла XML

□ Генерировать классы

DataSet

□ Генерировать классы времени выполнения, которые имеют специальные атрибуты для

XmlSerilization

□ Генерировать XSD из классов, которые уже были разработаны

□ Ограничивать список элементов, которые создаются в коде

□ Определять, на каком языке программирования должен быть представлен генерируемый код (C#, VB.NET, или JScript.NET)

□ Создавать схемы из типов в компилированных сборках

В документации платформы можно найти подробное описание параметров командной строки.

Несмотря на предлагаемые возможности, вовсе не обязательно использовать

xsd.exe

SerialSample1

Product

pd

private void button1_Click(object sender, System.EventArgs e) {

 // новый объект Products

 Products pd=new Products();

 // задать некоторые свойства

 pd.ProductXD=200;

 pd.CategoryID=100;

 pd.Discontinued=false;

 pd.ProductName="Serialize Objects";

 pd.QuantityPerUnit="6";

 pd.ReorderLevel=1;

 pd.SupplierID=1;

 pd.UnitPrice=1000;

 pd.UnitsInStock=10;

 pd.UnitsOnOrder=0;

Метод

Serialize

XmlSerializer

Stream

TextWriter

XmlWriter

tr

TextWriter

sr

XmlSerializer

XmlSerializer

typeof

sr

Serialize

tr

Stream

pd

 //новый TextWriter и XmlSerializer

 TextWriter tr=new StreamWriter("..\\..\\..\\serialprod.xml");

 XmlSerializer sr=new XmlSerializer(typeof(Products));

 // сериализуем объект

 sr.Serialize(tr,pd);

 tr.Close();

}

Здесь мы добавляем событие другой кнопки для создания нового объекта

newPd

Products

FileStream

private void button2_Click(object sender, System.EventArgs e) {

 // создаем ссылку на тип Products Products newPd;

 // новый файловый поток для открытия сериализованного объекта

 FileStream f=new FileStream("..\\..\\..\\serialprod.xml", FileMode.Open);

Здесь создается новый объект

XmlSerializer

Product

Deserialize

newPd

pd

 // новый Serializer

 XmlSerializer newSr=new XmlSerializer(typeof(Products));

 // десериализация объекта

 newPd=(Products)newSr.Deserialize(f);

 // загружаем его в окно списка.

 listBox1.Items.Add(newPd.ProductName);

 f.Closed();

}

Теперь мы проверим класс

Products

SystemAttribute

//класс, который будет сериализован,

//атрибуты определяют, как объект сериализуется.

[System.Xml.Serialization.XmlRootAttribute(Namespace="", IsNullable=false)]

public class Products {

 [System.Xml.Serialization.XmlElementAttribute(IsNullable=false)]

 public int ProductID;

 [System.Xml.Serialization.XmlElementAttribute(IsNullable=false)]

 public string ProductName;

 [System.Xml.Serialization.XmlElementAttribute()]

 public int SupplierID;

 [System.Xml.Serialization.XmlElementAttribute()]

 public int CategoryID;

 [System.Xml.Serialization.XmlElementAttribute()]

 public string QuantityPerUnit;

 [System.Xml.Serialization.XmlElementAttribute()]

 public System.Decimal UnitPrice;

 [System.Xml.Serialization.XmlElementAttribute()]

 public short UnitsInStock;

 [System.Xml.Serialization.XmlElementAttribute()]

 public short UnitsOnOrder;

 [System.Xml.Serialization.XmlElementAttribute()]

 public short ReorderLevel;

 [System.Xml.Serialization.XmlElementAttribute()]

 public bool Discontinued;

}

Созданный документ XML выглядит, как любой другой документ XML, который мы могли бы создать.

<?xml version="1.0" ?>

<Products xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">

 <ProductID>200</ProductID>

 <ProductName>Serialize Objects</ProductName>

 <SupplierID>1</SupplierID>

 <CategoryID>100</CategoryID>

 <QuantityPerUnit>6</QuantityPerUnit>

 <UnitPrice>1000</UnitPrice>

 <UnitsInStock>10</UnitsInStock>

 <UnitsOnOrder>0</UnitsOnOrder>

 <ReorderLevel>1</ReorderLevel>

 <Discontinued>false</Discontinued>

</Products>

Здесь нет ничего необычного. Мы могли бы выполнить преобразование документа XML и вывести его как HTML, загрузить его в

DataSet

XmlDocument

pd

Рассмотренный только что пример является очень простым. Обычно имеется ряд методов получения (get) и задания (set) свойств для работы с данными в объекте. Но что, если объект состоит из двух других объектов, или выводится из базового класса, из которого следуют и другие классы?

Такие ситуации обрабатываются с помощью класса

XmlSerializer

SerialSample2

private void button1_Click(object sender, System.EventArgs e) {

 // новый объект products

 Products pd=new Products();

 // задать некоторые свойства

 pd.ProductID=200;

 pd.CategoryID=100;

 pd.Discontinued=false;

 pd.ProductName="Serialize Objects";

 pd.QuantityPerUnit="6";

 pd.ReorderLevel=1;

 pd.SupplierID=1;

 pd.UnitPrice=1000;

 pd.UnitsInStock=10;

 pd.UnitsOnOrder= 0;

 pd.Discount=2;

 //новые TextWriter и XmlSerializer

 TextWriter tr=new StreamWriter("..\\..\\..\\serialprod1.xml");

 XmlSerializer sr=new XmlSerializer(typeof(Products));

 // сериализируем объект

 sr.Serialize(tr, pd);

 tr.Close();

}

private void button2_Click(object sender, System.EventArgs e) {

 //создать ссылку на тип Products

 Products newPd;

 // новый файловый поток для открытия сериализуемого объекта

 FileStream f=new FileStream("..\\..\\..\\serialprod1.xml", FileMode.Open);

 // новый сериализатор

 XmlSerializer newSr=new XmlSerializer(typeof(Products));

 //десериализуем объект

 newPd=(Products)newSr.Deserialize(f);

 //загрузить его в окно списка.

 listBox1.Items.Add(newPd.ProductName);

 f.Close();

}

//класс, который будет сериализован.

//атрибуты определяют, как объект сериализуется

[System.Xml.Serialization.XmlRootAttribute()]

public class Products {

 private int prodId;

 private string prodName;

 private int suppId;

 private int catId;

 private string qtyPerUnit;

 private Decimal unitPrice;

 private short unitsInStock;

 private short unitsOnOrder;

 private short reorderLvl;

 private bool discont;

 private int disc;

 // добавлен атрибут Discount

 [XmlAttributeAttribute(AttributeName="Discount")]

 public int Discount {

  get {return disc;}

  set {disc=value;}

 }

 [XmlElementAttribute()]

 public int ProductID {

  get {return prodId;}

  set {prodId=value;}

 }

 [XmlElementAttribute()]

 public string ProductName {

  get {return prodName;}

  set {prodName=value;}

 }

 [XmlElementAttribute()]

 public int SupplierID {

  get {return suppId;}

  set {suppId=value;}

 }

 [XmlElementAttribute()]

 public int CategoryID {

  get {return catId;}

  set {catId=value;}

 }

 [XmlElementAttribute()]

 public string QuantityPerUnit {

  get {return qtyPerUnit;}

  set {qtyPerUnit=value;}

 }

 [XmlElementAttribute()]

 public Decimal UnitPrice {

  get {return UnitPrice;}

  set {unitPrice=value;}

 }

 [XmlElementAttribute()]

 public short UnitsInStock {

  get {return unitsInStock;}

  set {unitsInStock=value;}

 }

 [XmlElementAttribute()]

 public short UnitsOnOrder {

  get {return unitsOrOrder;}

  set {unitsOnOrder=value;}

 }

 [XmlElementAttribute()]

 public short ReorderLevel {

  get {return reorderLvl;}

  set {reorderLvl=value;}

 }

 [XmlElementAttribute()]

 public pool Discontinued {

  get {return discont;}

  set {discont=value;}

 }

}

Выполнение этого кода вместо класса

Products

Discount

serialprod1.xml

<?xml version="1.0" encoding="utf-8"?>

<Products xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" Discount="2">

 <ProductID>200</ProductID>

 <ProductName>Serialize Objects</ProductName>

 <SupplierID>1</SupplierID>

 <CategoryID>100</CategoryID>

 <QuantityPerUnit>6</QuantityPerUnit>

 <UnitPrice>1000</UnitPrice>

 <UnitsInStock>10</UnitsInStock>

 <UnitsOnOrder>0</UnitsOnOrder>

 <ReorderLevel>1</ReorderLevel>

 <Discontinued>false</Discontinued>

</Products>

Отметим атрибут

Discount

Products

Что можно сказать о ситуации, когда имеются производные классы и, возможно, свойства, которые возвращают массив?

XmlSerializer

В событии

button1_Click

Product

BookProduct

newProd

newBook

Product

Inventory

Inventory

private void button1_Click(object sender, System.EventArgs e) {

 // создать новые объекты книги и книжной продукции

 Product newProd=new Product();

 BookProduct newBook=new BookProduct();

 // задать некоторые свойства

 newProd.ProductID=100;

 newProd.ProductName="Product Thing";

 newProd.SupplierID=10;

 newBook.ProductID=101;

 newBook.ProductName="How to Use Your New Product Thing";

 newBook.SupplierID=10;

 newBook.ISBN="123456789";

 //поместить элементы в массив

 Product[] addProd={newProd, newBook};

 // новый объект Inventory с помощью массива addProd

 Inventory inv=new Inventory();

 inv.InventoryItems=addProd;

 // сериализуем объект Inventory

 TextWriter tr=new StreamWriter("..\\..\\..\\order.xml");

 XmlSerializer sr=new XmlSerializer(typeof(Inventory));

 sr.Serialize(tr, inv);

 tr.Close();

}

Отметим в событии

button2_Click

newInv

private void button2_Click(object sender, System.EventArgs e) {

 Inventory newInv;

 FileStream f=new FileStream("..\\..\\..\\order.xml", FileMode.Open);

 XmlSerializer newSr=new XmlSerializer(typeof{Inventory));

 newInv=(Inventory)newSr.Deserialize(f);

 foreach(Product prod in newInv.Inventory Items) listBox1.Items.Add(prod.ProductName);

 f.Close();

}

public class inventory {

 private Product[] stuff;

 public Inventory() {}

Мы имеем

XmlArrayItem

ElementName

Product

BookProduct

XmlArrayAttribute

XmlArrayItemAttribute

 // необходимо иметь запись атрибута для каждого типа данных

 [XmlArrayItem("Prod", typeof(Product)), XmlArrayItem("Book", typeof(BookProduct))]

 //public Inventory(Product [] InventoryItems) {

 // stuff=InventoryItems;

 //}

 public Product[] InventoryItems {

  get {return stuff;}

  set {stuff=value;}

 }

}

//класс Product

public class Product {

 private int prodId;

 private string prodName;

 private int suppId;

 public Product() {}

 public int ProductID {

  get {return prodId;}

  set {prodId=value;}

 }

 public string ProductName {

  get {return prodName;}

  set {prodName=value;}

 }

 public int SupplierID {

  get {return suppId;}

  set {suppId=value;}

 }

}

// Класс Bookproduct

public class BookProduct: Product {

 private string isbnNum;

 public BookProduct() {}

 public string ISBN {

  get {return isbnNum;}

  set {isbnNum=value;}

 }

}

В этот пример добавлено два новых класса. Класс

Inventory

Product

BookProduct

Product

Inventory

BookProducts

Products

<?xml version="1.0" ?>

<Inventory xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">

 <InventoryItems>

  <Prod>

   <ProductID>100</ProductID>

   <ProductName>Product Thing</ProductName>

   <SupplierID>10</SupplierID>

  </Prod>

  <Book>

   <ProductID>101</ProductID>

   <ProductName>How to Use Your New Product Thing</ProductName>

   <SupplierID>10</SupplierID>

   <ISBN>123456789</ISBN>

  </Book>

 </InventoryItems>

</Inventory>

Все это работает прекрасно, но как быть в ситуации, когда нет доступа к исходному коду типов, которые будут сериализироваться? Невозможно добавить атрибут, если отсутствует исходный код. Существует другой способ. Можно воспользоваться классами

XmlAttributes

XmlAtrtributeOverrides

SerialSample4

private void button1_Click(object sender, System.EventArgs e) {

 // создать объект XmlAttributes XmlAttributes attrs=new XmlAttributes();

 // добавить типы объектов, которые будут сериализированы

 attrs.XmlElements.Add(new XmlElementAttribute("Book", typeof(BookProduct)));

 attrs.XmlElements.Add(new XmlElementAttribute("Product", typeof(Product)));

 XmlAttributeOverrides attrOver=new XmlAttributeOverrides();

 //добавить к коллекций атрибутов

 attrOver.Add(typeof(Inventory), "InventoryItems", attrs);

 // создать объекты Product и Book

 Product newProd=new Product();

 BookProduct newBook=new BookProduct();

 newProd.ProductID=100;

 newProd.ProductName="Product Thing";

 newProd.SupplierID=10;

 newBook.ProductID=101;

 newBook.ProductName="How to Use Your New Product Thing";

 newBook.SupplierID=10;

 newBook.ISBN="123456789";

 Product[] addProd={newProd, newBook};

 //Product[] addProd={newBook};

 Inventory inv=new Inventory();

 inv.InventoryItems=addProd;

 TextWriter tr=new StreamWriter("..\\..\\..\\inventory.xml");

 XmlSerializer sr=new XmlSerializer(typeof(Inventory), attrOver);

 sr.Serialize(tr, inv);

 tr.Close();

}

private void button2_Click(object sender, System.EventArgs e) {

 //необходимо выполнить тот же процесс для десериализации

 // создаем новую коллекцию XmlAttributes

 XmlAttributes attrs=new XmlAttributes();

 // добавляем информацию о типе к коллекции элементов

 attrs.XmlElements.Add(new XmlElementAttribute("Book", typeof(BookProduct)));

 attrs.XmlElements.Add(new XmlElementAttribute("Product", typeof(Product)));

 XmlAttributeOverrides attrOver=new XmlAttributeOverrides();

 //добавляем к коллекции Attributes (атрибутов)

 attrOver.Add(typeof(Inventory), "InventoryItems", attrs);

 //нужен новый объект Inventory для десериализаций в него

 Inventory newInv;

 // десериализуем и загружаем данные в окно списка из

 // десериализованного объекта

 FileStream f=new FileStream("..\\..\\..\\inventory.xml", FileMode.Open);

 XmlSerializer newSr=new XmlSerializer(typeof(Inventory).attrOver);

 newInv=(Inventory)newSr.Deserialize(f);

 if (newInv!=null) {

  foreach(Product prod in newInv.InventoryItems) listBox1.Items.Add(prod.ProductName);

 }

 f.Close();

}

// это те же классы, что и в предыдущем примере

// за исключением удаленных атрибутов

// из свойства InventoryItems для Inventory

public class Inventory {

 private Product[] stuff;

 public Inventory() {}

 public Product[] InventoryItems {

  get {return stuff;}

  set {stuff=value;}

 }

}

public class Product {

 private int prodId;

 private string prodName;

 private int suppId;

 public Product() {}

 public int ProductID {

  get {return prodId;}

  set {prodId=value;}

 }

 public string ProductName {

  get {return prodName;}

  set {prodName=value;}

 }

 public int SupplierID {

  get {return suppId;}

  set {suppId=value;}

 }

}

public class BookProduct:Product {

 private string isbnNum;

 public BookProduct() {}

 public string ISBN {

  get {return isbnNum;}

  set {isbnNum=value;}

 }

}

Это тот же пример, что и раньше, но первое, что необходимо заметить,— здесь нет добавленных в класс

Inventory

Inventory

Product

BookProduct

Первым шагом в процессе является создание объекта на основе

XmlAttributes

XmlElementAttribute

XmlAttributes attrs=new XmlAttributes();

attrs.XmlElements.Add(new XmlElementAttribute("Book", typeof(BookProduct)));

attrs.XmlElements.Add(new XmlElementAttribute("Product", typeof(Product)));

Здесь мы добавляем новый

XmlElementAttribute

XmlElements

XmlAttributes

XmlAttributes

XmlArray

XmlArrayItems

XmlAttributes

XmlElementAttribute

XmlElements

XmlAttributeOverrides

XmlAttributeOverrides attrOver = new XmlAttributeOverride();

attrOver.Add(typeof(Inventory) , "Inventory Items", attrs);

Meтод

Add

XmlAttributes

InventoryItems

Inventory

Теперь создадим объект

XmlSerializer

XmlAttributeOverrides

XmlSerializer

Serialize

<?xml version="1.0"?>

<Inventory xmlns:xsi=http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">

 <Products>

  <ProductID>100</ProductID>

  <ProductName>Product Thing</ProductName>

  <SupplierID>10</SupplierID>

 </Product>

 <Book>

  <ProductID>101</ProductID>

  <ProductName>How to Use Your New Product Thing</ProductName>

  <SupplierID>10</SupplierID>

  <ISBN>123456789</ISBN>

 </Book>

</Inventory>

Мы получили тот же самый XML, что и в предыдущем примере. Чтобы десериализовать этот объект и воссоздать объект на основе Inventory, с которого мы начали, необходимо создать все те же объекты

XmlAttributes

XmlElementAttribute

XmlAttributeOverrides

Inventory

Inventory

private void button2_Click(object sender, System.EventArgs e) {

 XmlAttributes attrs=new XmlAttributes();

 attrs.XmlElements.Add(new XmlElementAttribute("Book", typeof(BookProduct)));

 attrs.XmlElements.Add(new XmlElementAttribute("Product", typeof(Product)));

 XmlAttributeOverrides attrOver=new XmlAttributeOverrides();

 attrOver.Add(typeof(Inventory), "InventoryItems", attrs);

 Inventory newInv;

 FileStream f=new FileStream("..\\..\\..\\inventory.xml", FileMode.Open);

 XmlSerializer newSr=new XmlSerializer(typeof(Inventory), attrOver);

 newInv=(Inventory)newSr.Deserialize(f);

 foreach(Product prod, in newInv.InventoryItems) listBox1.items.Add(prod.ProductName);

 f.Close();

}

Отметим, что первые несколько строк кода идентичны коду, который использовался для сериализации объекта.

Пространство имен

XmlSerialize

В этой главе рассматривались широкие возможности пространства имен

System.Xml

XMLReader

XMLWriter

DataSet

Reflection

XMLSerilization

XPath

XslTransform