XmlDataSource.TransformFile Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Especifica el nombre de un archivo con extensión .xsl (Extensible Stylesheet Language) que define una transformación XSLT que se realizará en los datos XML que administra el control XmlDataSource.
public:
virtual property System::String ^ TransformFile { System::String ^ get(); void set(System::String ^ value); };public virtual string TransformFile { get; set; }member this.TransformFile : string with get, setPublic Overridable Property TransformFile As StringValor de propiedad
Ruta de acceso física absoluta o relativa del archivo de hoja de estilos XSL que define una transformación XML que se va a realizar en los datos incluidos en las propiedades Data o DataFile. El valor predeterminado es Empty.
Excepciones
El documento se está cargando.
Ejemplos
En el ejemplo de código siguiente se muestra cómo usar un XmlDataSource control y un TreeView control para mostrar datos XML transformados en un formulario web. La transformación se realiza mediante la hoja de estilos indicada por la TransformFile propiedad . Opcionalmente, puede proporcionar argumentos de transformación para la hoja de estilos mediante .XsltArgumentList Para obtener más información, vea la propiedad TransformArgumentList.
<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>ASP.NET Example</title>
</head>
<body>
<form id="form1" runat="server">
<asp:XmlDataSource
id="XmlDataSource1"
runat="server"
datafile="bookstore.xml"
transformfile="bookstore.xsl"/>
<!- TreeView uses hierachical data, so the
XmlDataSource uses an XmlHierarchicalDataSourceView
when a TreeView is bound to it. -->
<asp:treeview
id="TreeView1"
runat="server"
datasourceid="XmlDataSource1">
<databindings>
<asp:treenodebinding depth="1" datamember="genre"
textfield="name" valuefield="name"/>
<asp:treenodebinding depth="2" datamember="book"
textfield="title" valuefield="ISBN"/>
<asp:treenodebinding depth="3" datamember="chapter"
textfield="name" valuefield="num"/>
</databindings>
</asp:treeview>
</form>
</body>
</html>
<%@ Page Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>ASP.NET Example</title>
</head>
<body>
<form id="form1" runat="server">
<asp:xmldatasource
id="XmlDataSource1"
runat="server"
datafile="bookstore.xml"
transformfile="bookstore.xsl"/>
<!- TreeView uses hierachical data, so the
XmlDataSource uses an XmlHierarchicalDataSourceView
when a TreeView is bound to it. -->
<asp:treeview
id="TreeView1"
runat="server"
datasourceid="XmlDataSource1">
<databindings>
<asp:treenodebinding depth="1" datamember="genre"
textfield="name" valuefield="name"/>
<asp:treenodebinding depth="2" datamember="book"
textfield="title" valuefield="ISBN"/>
<asp:treenodebinding depth="3" datamember="chapter"
textfield="name" valuefield="num"/>
</databindings>
</asp:treeview>
</form>
</body>
</html>
El archivo XML del ejemplo de código tiene los datos siguientes:
<bookstore>
<genre name="fiction">
<book ISBN="0000000000">
<title>Secrets of Silicon Valley</title>
<price>12.95</price>
<chapters>
<chapter num="1" name="Introduction" />
<chapter num="2" name="Body" />
<chapter num="3" name="Conclusion" />
</chapters>
</book>
</genre>
<genre name="novel">
<book genre="novel" ISBN="1111111111">
<title>Straight Talk About Computers</title>
<price>24.95</price>
<chapters>
<chapter num="1" name="Introduction" />
<chapter num="2" name="Body" />
<chapter num="3" name="Conclusion" />
</chapters>
</book>
</genre>
</bookstore>
La hoja de estilos XSL que realiza la transformación XML tiene la siguiente estructura:
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
<xsl:template match="bookstore">
<bookstore>
<xsl:apply-templates select="genre"/>
</bookstore>
</xsl:template>
<xsl:template match="genre">
<genre>
<xsl:attribute name="name">
<xsl:value-of select="@name"/>
</xsl:attribute>
<xsl:apply-templates select="book"/>
</genre>
</xsl:template>
<xsl:template match="book">
<book>
<xsl:attribute name="ISBN">
<xsl:value-of select="@ISBN"/>
</xsl:attribute>
<xsl:attribute name="title">
<xsl:value-of select="title"/>
</xsl:attribute>
<xsl:attribute name="price">
<xsl:value-of select="price"/>
</xsl:attribute>
<xsl:apply-templates select="chapters/chapter" />
</book>
</xsl:template>
<xsl:template match="chapter">
<chapter>
<xsl:attribute name="num">
<xsl:value-of select="@num"/>
</xsl:attribute>
<xsl:attribute name="name">
<xsl:value-of select="@name"/>
</xsl:attribute>
<xsl:apply-templates/>
</chapter>
</xsl:template>
</xsl:stylesheet>
Comentarios
Si se establecen las TransformFile propiedades y Transform , la TransformFile propiedad tiene prioridad y los datos del archivo de hoja de estilos XSL (.xsl) se usan en lugar de los elementos de hoja de estilos especificados en la Transform propiedad . Si se establece una expresión XPath mediante la XPath propiedad , se aplica después de transformar los datos XML.
Si cambia el valor de la Transform propiedad , se genera el DataSourceChanged evento . Si el almacenamiento en caché está habilitado y cambia el valor de Transform, la memoria caché se invalida.
Nota:
La XmlDataSource clase usa la clase en desuso XslTransform para realizar transformaciones XSL. Si desea usar las características de hoja de estilos que se introdujeron después de que la XslTransform clase haya quedado en desuso, aplique las transformaciones manualmente mediante la XslCompiledTransform clase .
