XmlDataSource.Transform Özellik

  • Başvuru

Tanım

Ad Alanı:
System.Web.UI.WebControls
Bütünleştirilmiş Kod:
System.Web.dll

Denetim tarafından yönetilen XML verilerinde gerçekleştirilecek XSLT dönüştürmesini tanımlayan Genişletilebilir Stil Sayfası Dili (XSL) veri bloğunu XmlDataSource alır veya ayarlar.

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

Özellik Değeri

String

veya DataFile özelliklerinde yer alan veriler üzerinde gerçekleştirilecek xml dönüştürmesini Data tanımlayan satır içi XSL dizesi. Empty varsayılan değerdir.

Öznitelikler
TypeConverterAttribute PersistenceModeAttribute

Özel durumlar

InvalidOperationException

Belge yükleniyor.

Örnekler

Aşağıdaki kod örneği, dönüştürülmüş XML verilerini görüntülemek için bir denetimin şablonlu Repeater denetimle nasıl kullanılacağını XmlDataSource gösterir. Dönüştürmeyi gerçekleştiren stil sayfası, veri kaynağı denetiminin Transform özelliği tarafından satır içinde tanımlanır.

Kod örneğindeki XML dosyasında aşağıdaki veriler vardır:

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

Açıklamalar

Bildirim temelli senaryolarda özelliği, nesnesinin Transform çok satırlı iç özelliği XmlDataSource olarak belirtilir. İç özellik, stil sayfasını herhangi bir şekilde biçimlendirmenize ve tırnak karakterleri doldurma gibi karakter doldurma sorunlarını yoksaymanıza olanak sağladığından XSL stil sayfası verileriyle uyumludur.

Hem hem de TransformFileTransform özellikleri ayarlanırsa, TransformFile özellik öncelikli olur ve özellikte belirtilen stil sayfası öğeleri yerine XSL stil sayfası dosyasındaki Transform (.xsl) veriler kullanılır. Bir XPath ifadesi özelliği kullanılarak XPath ayarlanırsa, XML verileri dönüştürüldükten sonra uygulanır.

özelliğinin Transform değerini değiştirirseniz, DataSourceChanged olay oluşturulur. Önbelleğe alma etkinse ve değerini Transformdeğiştirirseniz önbellek geçersiz kılınır.

Not

sınıfı, XmlDataSource XSL dönüştürmeleri gerçekleştirmek için kullanım XslTransform dışı sınıfını kullanır. Sınıf kullanım dışı bırakıldıktan sonra XslTransform tanıtılan stil sayfası özelliklerini kullanmak istiyorsanız, sınıfını kullanarak XslCompiledTransform dönüştürmeleri el ile uygulayın.

Şunlara uygulanır

Ayrıca bkz.