XmlDataSource.Transform Özellik

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

Özellik Değeri

String

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

Ö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 özelliği öncelik kazanır 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.

Uyarı

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

Ayrıca bkz.

• TransformFile
• CacheKeyDependency