XmlDataSource.Transform Vlastnost

Definice

Obor názvů:

System.Web.UI.WebControls

Sestavení:

System.Web.dll

Získá nebo nastaví blok dat XSL (Extensible Stylesheet Language), který definuje transformace XSLT, která má být provedena na data XML spravované ovládacím XmlDataSource prvku.

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

Hodnota vlastnosti

String

Řetězec vloženého XSL, který definuje transformaci XML, která se má provést s daty obsaženými ve Data vlastnostech nebo DataFile . Výchozí hodnota je Empty.

Atributy

TypeConverterAttribute PersistenceModeAttribute

Výjimky

InvalidOperationException

Dokument se načítá.

Příklady

Následující příklad kódu ukazuje, jak použít ovládací prvek XmlDataSource s ovládacím prvku šablonou Repeater k zobrazení transformovaných dat XML. Šablona stylů, která provádí transformaci, je definována vloženou Transform vlastností ovládacího prvku zdroje dat.

Soubor XML v příkladu kódu obsahuje následující data:

<?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>  

Poznámky

V deklarativních scénářích Transform je vlastnost určena jako víceřádkovou vnitřní vlastnost objektu XmlDataSource . Vnitřní vlastnost je kompatibilní s daty šablon stylů XSL, protože umožňuje libovolně formátovat šablonu stylů a ignorovat problémy s odsazením znaků, jako jsou znaky uvozovek.

Pokud jsou vlastnosti a TransformFileTransform nastaveny, TransformFile vlastnost má přednost a místo prvků šablony stylů XSL (.xsl) se místo prvků šablony stylů zadaných ve vlastnosti použijí data v Transform souboru šablony stylů XSL. Pokud je výraz XPath nastaven pomocí XPath vlastnosti, použije se po transformaci dat XML.

Pokud změníte hodnotu Transform vlastnosti, vyvolá se DataSourceChanged událost. Pokud je ukládání do mezipaměti povolené a změníte hodnotu Transform, mezipaměť se zneplatní.

Poznámka

Třída XmlDataSource používá zastaralou XslTransform třídu k provádění transformací XSL. Pokud chcete použít funkce šablon stylů, které byly zavedeny po XslTransform vyřazení třídy, použijte transformace ručně pomocí XslCompiledTransform třídy.

Viz také

• TransformFile
• CacheKeyDependency