XmlDataSource.Transform Свойство

Определение

Возвращает или задает блок данных расширяемого языка таблицы стилей (XSL), определяющих преобразование XSLT, выполняемое для XML-данных, управляемых элементом XmlDataSource управления.

public:
 virtual property System::String ^ Transform { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.TypeConverter("System.ComponentModel.MultilineStringConverter,System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089")]
[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)]
public virtual string Transform { get; set; }
[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)]
[System.ComponentModel.TypeConverter("System.ComponentModel.MultilineStringConverter,System, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089")]
public virtual string Transform { get; set; }
[<System.ComponentModel.TypeConverter("System.ComponentModel.MultilineStringConverter,System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089")>]
[<System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)>]
member this.Transform : string with get, set
[<System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)>]
[<System.ComponentModel.TypeConverter("System.ComponentModel.MultilineStringConverter,System, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089")>]
member this.Transform : string with get, set
Public Overridable Property Transform As String

Значение свойства

Строка встроенного XSL, определяющая преобразование XML для выполнения данных, содержащихся в Data или DataFile свойствах. Значение по умолчанию — Empty.

Атрибуты

Исключения

Документ загружается.

Примеры

В следующем примере кода показано, как использовать XmlDataSource элемент управления с шаблонным элементом управления для отображения преобразованных Repeater XML-данных. Таблица стилей, которая выполняет преобразование, определяется встроенным Transform свойством элемента управления источником данных.

XML-файл в примере кода содержит следующие данные:

<?xml version="1.0" encoding="iso-8859-1"?>
 <orders>
   <order>
     <customer id="12345" />
     <customername>
         <firstn>Todd</firstn>
         <lastn>Rowe</lastn>
     </customername>
     <transaction id="12345" />
     <shipaddress>
         <address1>1234 Tenth Avenue</address1>
         <city>Bellevue</city>
         <state>Washington</state>
         <zip>98001</zip>
     </shipaddress>
     <summary>
         <item dept="tools">screwdriver</item>
         <item dept="tools">hammer</item>
         <item dept="plumbing">fixture</item>
     </summary>
   </order>
</orders>

Комментарии

В декларативных сценариях Transform свойство указывается как многостроочное внутреннее свойство XmlDataSource объекта. Внутреннее свойство совместимо с данными таблицы стилей XSL, так как позволяет форматировать таблицу стилей любым образом и игнорировать проблемы с заполнением символов, например символы кавычки с заполнением.

TransformFile Transform Если заданы оба свойства, свойство имеет приоритет, TransformFile а данные в файле таблицы стилей XSL (XSL) используются вместо элементов таблицы стилей, указанных в свойствеTransform. Если выражение XPath задано с помощью XPath свойства, оно применяется после преобразования XML-данных.

При изменении значения Transform свойства DataSourceChanged вызывается событие. Если кэширование включено и вы изменяете значение Transform, кэш недействителен.

Замечание

Класс XmlDataSource использует устаревший XslTransform класс для выполнения преобразований XSL. Если вы хотите использовать функции таблицы стилей, которые были представлены после XslTransform отмены класса, примените преобразования вручную с помощью XslCompiledTransform класса.

Применяется к

См. также раздел