XmlDataSource.TransformFile Propriété

Référence

Définition

Espace de noms:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Spécifie le nom d'un fichier XSL (Extensible Stylesheet Language) (.xsl) qui définit une transformation XSLT à exécuter sur les données XML gérées par le contrôle 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, set

Public Overridable Property TransformFile As String

Valeur de propriété

String

Le chemin d'accès physique absolu ou le chemin d'accès relatif du fichier de feuille de style XSL qui définit une transformation XML à exécuter sur les données contenues dans les propriétés Data ou DataFile. La valeur par défaut est Empty.

Exceptions

InvalidOperationException

Le document est en cours de chargement.

Exemples

L’exemple de code suivant montre comment utiliser un XmlDataSource contrôle et un TreeView contrôle pour afficher des données XML transformées sur un formulaire Web. La transformation est effectuée à l’aide de la feuille de style indiquée par la TransformFile propriété . Vous pouvez éventuellement fournir des arguments de transformation pour la feuille de style à l’aide d’un XsltArgumentList. Pour plus d'informations, consultez la propriété 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>

Le fichier XML de l’exemple de code contient les données suivantes :

<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 feuille de style XSL qui effectue la transformation XML a la structure suivante :

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

Remarques

Si les TransformFile propriétés et Transform sont définies, la TransformFile propriété est prioritaire et les données du fichier de feuille de style XSL (.xsl) sont utilisées à la place des éléments de feuille de style spécifiés dans la Transform propriété . Si une expression XPath est définie à l’aide de la XPath propriété , elle est appliquée après la transformation des données XML.

Si vous modifiez la valeur de la Transform propriété, l’événement DataSourceChanged est déclenché. Si la mise en cache est activée et que vous modifiez la valeur de Transform, le cache n’est pas valide.

Notes

La XmlDataSource classe utilise la classe dépréciée XslTransform pour effectuer des transformations XSL. Si vous souhaitez utiliser des fonctionnalités de feuille de style introduites après la dépréciation de la XslTransform classe, appliquez les transformations manuellement à l’aide de la XslCompiledTransform classe .

S’applique à