XmlDataSource.Transform 屬性

定義

命名空間:

System.Web.UI.WebControls

組件:

System.Web.dll

取得或設定可延伸樣式表語言 (XSL) 資料的區塊，該資料會定義要在 XmlDataSource 控制項所管理的 XML 資料上執行的 XSLT 轉換。

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

屬性值

String

內嵌 XSL 字串，定義 Data 或 DataFile 屬性中所含資料所要執行的 XML 轉換。 預設值是 Empty。

屬性

TypeConverterAttribute PersistenceModeAttribute

例外狀況

InvalidOperationException

此文件正在載入。

範例

下列程式碼範例示範如何使用 XmlDataSource 控制項搭配樣板化 Repeater 控制項來顯示已轉換的 XML 資料。 執行轉換的樣式表單是由 Transform 資料來源控制項的 屬性內嵌定義。

程式碼範例中的 XML 檔案具有下列資料：

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

備註

在宣告式案例中 Transform ，屬性會指定為 物件的多行內部屬性 XmlDataSource 。 內部屬性與 XSL 樣式表單資料相容，因為它可讓您以任何方式格式化樣式表單，並忽略字元填補問題，例如填補引號字元。

如果同時 TransformFile 設定 和 Transform 屬性，則會 TransformFile 優先使用 屬性，而 XSL 樣式表單檔案中的資料 (.xsl) ，而不是 屬性中指定的 Transform 樣式表單元素。 如果使用 屬性設定 XPath XPath 運算式，則會在轉換 XML 資料之後套用它。

如果您變更 屬性的值 Transform ，就會 DataSourceChanged 引發 事件。 如果已啟用快取，而且您變更 的值 Transform ，快取就會失效。

注意

類別 XmlDataSource 會使用已被取代的 XslTransform 類別來執行 XSL 轉換。 如果您想要使用類別已被取代之後 XslTransform 引進的樣式表單功能，請使用 類別手動套用 XslCompiledTransform 轉換。

另請參閱

• TransformFile
• CacheKeyDependency