Общие сведения о серверном веб-элементе управления XML

Статья
10/22/2014

Обновлен: Ноябрь 2007

Серверный веб-элемент управления Xml используется для отображения содержимого документа XML без форматирования или использования XSL-преобразований.

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

Сценарии
Базовые сведения
Примеры кода
Ссылки на классы

Сценарии

Серверный веб-элемент управления Xml выполняет чтение XML-файла и записывает его на веб-страницу ASP.NET в место размещения данного элемента управления. Если к XML-файлу применяется XSL-преобразование (XSLT), полученные преобразованные выходные данные будут отображаться на странице.

К началу

Базовые сведения

Серверный веб-элемент управления XML можно использовать для записи документа XML или результата преобразования XSLT на веб-страницу ASP.NET. Выходные данные XML отображаются на веб-странице в месте размещения элемента управления.

Примечание.
Чтобы использовать данные XML в качестве источника данных для других элементов управления, таких как Repeater, DataList или GridView, можно использовать элемент управления XmlDataSource. Подробные сведения см. в разделе Общие сведения о серверном веб-элементе управления XmlDataSource.

Чтобы использовать данные XML в качестве источника данных для других элементов управления, таких как Repeater, DataList или GridView, можно использовать элемент управления XmlDataSource. Подробные сведения см. в разделе Общие сведения о серверном веб-элементе управления XmlDataSource.

Сведения XML и XSLT могут находиться во внешних документах, но данные XML также могут быть встроены в веб-страницу. Существует два способа ссылки на внешние документы с использованием параметров свойств серверного веб-элемента управления XML. Можно задать путь к документу XML в теге элемента управления или загрузить документы XML и XSLT как объекты и передать их элементу управления программным способом. Чтобы встроить данные XML-файла в страницу, его необходимо указать между открывающим и закрывающим тегом элемента управления.

Документ XML для отображения следует указать, задав одно из свойств, перечисленных в следующей таблице. Эти три свойства представляют различные типы документов XML для отображения. Определив соответствующее свойство, можно отобразить System.Xml.XmlDocument, строку XML или XML-файл.

Свойство	Описание
Document	Определяет документ XML с помощью объекта System.Xml.XmlDocument.
DocumentContent	Определяет документ XML с помощью строки. Примечание. Обычно это свойство задается декларативно, путем помещения текста между открывающими и закрывающими тегами <asp:Xml> элемента управления Xml.
DocumentSource	Определяет документ XML с помощью файла.

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

При необходимости можно также указать в свойствах таблицу стилей XSL-преобразования (XSLT), выполняющую форматирование документа XML перед его записью в поток вывода. Свойства представляют различные типы таблиц стилей XSL-преобразования, которые могут быть использованы для форматирования документа. Установив соответствующее свойство, можно отформатировать документ XML с помощью объекта System.Xml.Xsl.XslCompiledTransform или файла таблиц стилей для XSL-преобразования. Если ни одна из таблиц стилей XSL-преобразования не указана, то при отображении документа XML используется форматирование по умолчанию.

К началу