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