System.Web.UI.WebControls.XmlDataSource.Transform Property

Gets or sets a block of Extensible Stylesheet Language (XSL) data that defines an XSLT transformation to be performed on the XML data managed by the System.Web.UI.WebControls.XmlDataSource control.

Syntax

[System.ComponentModel.DefaultValue("")]
[System.ComponentModel.Editor("System.ComponentModel.Design.MultilineStringEditor,System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a", "System.Drawing.Design.UITypeEditor, System.Drawing, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)]
public virtual string Transform { set; get; }

Value

Documentation for this section has not yet been entered.

Remarks

In declarative scenarios, the XmlDataSource.Transform property is specified as a multiline inner property of the System.Web.UI.WebControls.XmlDataSource object. An inner property is compatible with XSL style sheet data, because it enables you to format the style sheet in any way and ignore character padding issues such as padding quote characters.

If both the XmlDataSource.TransformFile and XmlDataSource.Transform properties are set, the XmlDataSource.TransformFile property takes precedence and the data in the XSL style sheet file (.xsl) is used instead of the style sheet elements specified in the XmlDataSource.Transform property. If an XPath expression is set using the XmlDataSource.XPath property, it is applied after the XML data is transformed.

If you change the value of the XmlDataSource.Transform property, the System.Web.UI.IDataSource.DataSourceChanged event is raised. If caching is enabled and you change the value of XmlDataSource.Transform, the cache is invalidated.

Note:

The System.Web.UI.WebControls.XmlDataSource class uses the deprecated System.Xml.Xsl.XslTransform class to perform XSL transformations. If you want to use style sheet features that were introduced after the System.Xml.Xsl.XslTransform class was deprecated, apply the transforms manually by using the System.Xml.Xsl.XslCompiledTransform class.

Requirements

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in System.Web.dll)
Assembly Versions: 2.0.0.0
Since: .NET 2.0