Симон Робинсон - C# для профессионалов. Том II

//создать новый 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, a books.xslв transForm. В этом примере для записи нового документа HTML на диск создается объект FileStream.

Если бы это было приложение ASP.NET, мы использовали бы объект TextWriterи передавали бы его в объект HttpResponse. Если бы мы преобразовывали в другой документ XML, то применялся бы объект на основе XmlWriter. После того как объекты XPathDocumentи XslTransformбудут готовы, мы создаем XPathNavigatorна docи передаем navи этот streamв метод Transformобъекта transForm. XslTransformимеет несколько перегружаемых версий, получающих комбинации навигаторов, XsltArgumentList(подробнее об этом позже) и потоков ввода/вывода. Параметром навигатора может быть XPathNavigatorили любой объект, реализующий интерфейс IXPathNavigable. Потоки ввода/вывода могут быть TextWriter, Streamили объектом на основе XmlWriter.

Документ books.xslявляется таблицей стилей. Документ выглядит следующим образом:

Ранее упоминался объект 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) выглядит так:

The Autobiography of Benjamin Franklin

This came from the ShowText method!

The Confidence Man

This came from the ShowText method!

The Gorgias

This came from the ShowText method!

The Great Cookie Caper

This came from the ShowText method!

A Really Great Book

This came from the ShowText method!

Определим новый класс BookUtils. В этом классе мы имеем один практически бесполезный метод, который возвращает строку "This came from the ShowText method!". Для события button1_Clickсоздаются XPathDocumentи XslTransformтак же, как это делалось раньше, но с некоторыми исключениями. В этот раз мы собираемся создать документ XML, поэтому используем 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:

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

Иначе это можно было бы выполнить с помощью сценария XSLT. В таблицу стилей можно включить код C#, VB и JavaScript. Большим достоинством этого является то, что в отличие от текущих реализаций, сценарий компилируется при вызове Transform.Load; таким образом выполняются уже откомпилированные сценарии, в значительной степени так же, как работает ASP.NET. Давайте выполним предыдущий пример таким способом. Добавим сценарий к таблице стилей. Эти изменения можно увидеть в файле bookscript.xsl:

string ShowText() {

return "This came from the ShowText method!";

}

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

Ключевой момент, о котором необходимо помнить при выполнении преобразований, состоит в том, чтобы не забыть использовать подходящее хранилище; XPathDocument, если не требуется редактирование, XmlDataDocument, если данные получают из ADO.NET, и 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, содержащего XML, из DataSet, и загрузки XML в listbox аналогично тому, что делалось ранее. Чтобы выполнить несколько следующих примеров, необходимо добавить инструкции using:

using System.Data;

using System.Xml;

using System.Data.SqlClient;

using System.IO;

Также для примеров ADO в формы добавлены DataGrid, что позволит нам увидеть данные в DataSetиз ADO.NET, так как они ограничены сеткой, а также данные из созданных документов XML, которые загружаются в listbox. Вот код первого примера, который можно найти в папке ADOSample1: