XmlDataSource.Transform Properti

Referensi

Definisi

Ruang nama:: System.Web.UI.WebControls

Rakitan:: System.Web.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Mendapatkan atau mengatur blok data Extensible Stylesheet Language (XSL) yang menentukan transformasi XSLT yang akan dilakukan pada data XML yang dikelola oleh XmlDataSource kontrol.

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

Nilai Properti

String

String XSL sebaris yang menentukan transformasi XML yang akan dilakukan pada data yang terkandung dalam Data properti atau DataFile . Nilai defaultnya adalah Empty.

Atribut: TypeConverterAttribute PersistenceModeAttribute

Pengecualian

InvalidOperationException

Dokumen sedang dimuat.

Contoh

Contoh kode berikut menunjukkan cara menggunakan kontrol dengan kontrol templat Repeater untuk menampilkan data XML yang XmlDataSource diubah. Lembar gaya yang melakukan transformasi ditentukan sebaris oleh Transform properti kontrol sumber data.

File XML dalam contoh kode memiliki data berikut:

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

Keterangan

Dalam skenario deklaratif, Transform properti ditentukan sebagai properti dalam multibaris objek XmlDataSource . Properti dalam kompatibel dengan data lembar gaya XSL, karena memungkinkan Anda memformat lembar gaya dengan cara apa pun dan mengabaikan masalah padding karakter seperti karakter kutipan padding.

TransformFile Jika properti dan Transform diatur, TransformFile properti lebih diutamakan dan data dalam file lembar gaya XSL (.xsl) digunakan alih-alih elemen lembar gaya yang ditentukan dalam Transform properti . Jika ekspresi JalurX diatur menggunakan XPath properti , ekspresi tersebut diterapkan setelah data XML diubah.

Jika Anda mengubah nilai Transform properti , DataSourceChanged peristiwa akan dinaikkan. Jika penembolokan diaktifkan dan Anda mengubah nilai Transform, cache tidak valid.

Catatan

Kelas XmlDataSource menggunakan kelas yang tidak XslTransform digunakan lagi untuk melakukan transformasi XSL. Jika Anda ingin menggunakan fitur lembar gaya yang diperkenalkan setelah XslTransform kelas tidak digunakan lagi, terapkan transformasi secara manual dengan menggunakan XslCompiledTransform kelas .

Berlaku untuk

Bagikan melalui