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á se má provést s daty XML spravovanými 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 v datech Data nebo DataFile vlastnostech. 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 XmlDataSource ovládací prvek se šablonou Repeater ovládacího prvku 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řádkové vnitřní vlastnosti objektu XmlDataSource . Vnitřní vlastnost je kompatibilní s daty šablony stylů XSL, protože umožňuje formátovat šablonu stylů jakýmkoli způsobem a ignorovat problémy s odsazením znaků, jako jsou znaky odsazení uvozovek.

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

Pokud změníte hodnotu Transform vlastnosti, DataSourceChanged vyvolá se 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 šablony stylů, které byly zavedeny po XslTransform vyřazení třídy, použijte transformace ručně pomocí XslCompiledTransform třídy.

Viz také

• TransformFile
• CacheKeyDependency