XmlDataSource.Transform Egenskap

Definition

Namnområde:
System.Web.UI.WebControls
Sammansättning:
System.Web.dll

Hämtar eller anger ett block med XSL-data (Extensible Stylesheet Language) som definierar en XSLT-transformering som ska utföras på XML-data som hanteras av XmlDataSource kontrollen.

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

Egenskapsvärde

String

En sträng med infogad XSL som definierar en XML-transformering som ska utföras på de data som finns i Data egenskaperna eller DataFile . Standardvärdet är Empty.

Attribut
TypeConverterAttribute PersistenceModeAttribute

Undantag

InvalidOperationException

Dokumentet läses in.

Exempel

I följande kodexempel visas hur du använder en XmlDataSource kontroll med en mallbaserad Repeater kontroll för att visa transformerade XML-data. Formatmallen som utför omvandlingen definieras infogat av Transform egenskapen för datakällkontrollen.

XML-filen i kodexemplet har följande 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>

Kommentarer

I deklarativa scenarier anges egenskapen Transform som en inre egenskap för flera ledningar för XmlDataSource objektet. En inre egenskap är kompatibel med XSL-formatmallsdata eftersom det gör att du kan formatera formatmallen på något sätt och ignorera problem med utfyllnad av tecken, till exempel utfyllnadstecken.

Om både TransformFile egenskaperna och Transform anges TransformFile har egenskapen företräde och data i XSL-formatmallsfilen (.xsl) används i stället för de formatmallselement som anges i Transform egenskapen. Om ett XPath-uttryck anges med egenskapen XPath tillämpas det när XML-data transformeras.

Om du ändrar värdet för Transform egenskapen DataSourceChanged utlöses händelsen. Om cachelagring är aktiverat och du ändrar värdet Transformför , ogiltigförklaras cachen.

Note

Klassen XmlDataSource använder den inaktuella XslTransform klassen för att utföra XSL-transformeringar. Om du vill använda formatmallsfunktioner som introducerades efter XslTransform att klassen blev inaktuell tillämpar du transformeringarna manuellt med hjälp XslCompiledTransform av klassen.

Gäller för

Se även