XmlDataSource.Transform Свойство

Определение

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

System.Web.UI.WebControls

Сборка:

System.Web.dll

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

public:
 virtual property System::String ^ Transform { System::String ^ get(); void set(System::String ^ value); };

[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.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

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

String

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

Атрибуты

TypeConverterAttribute PersistenceModeAttribute

Исключения

InvalidOperationException

Выполняется загрузка документа.

Примеры

В следующем примере кода показано, как использовать 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 класса .

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

• TransformFile
• CacheKeyDependency