Deklarative Syntax des XML-Webserversteuerelements

Aktualisiert: November 2007

Zeigt ein XML‑Dokument oder das Ergebnis einer XSL‑Transformation an.

<asp:Xml
    DocumentSource="uri"
    EnableTheming="True|False"
    EnableViewState="True|False"
    ID="string"
    OnDataBinding="DataBinding event handler"
    OnDisposed="Disposed event handler"
    OnInit="Init event handler"
    OnLoad="Load event handler"
    OnPreRender="PreRender event handler"
    OnUnload="Unload event handler"
    runat="server"
    SkinID="string"
    TransformSource="string"
    Visible="True|False"
/>

Hinweise

Verwenden Sie das Xml-Steuerelement, um den Inhalt eines XML-Dokuments oder das Ergebnis einer XSL-Transformation anzuzeigen.

Das anzuzeigende XML‑Dokument wird durch Festlegen einer von drei Eigenschaften angegeben. Diese drei Eigenschaften stellen die unterschiedlichen Typen von XML‑Dokumenten dar, die angezeigt werden können. Sie können ein XmlDocument, eine XML-Zeichenfolge oder eine XML-Datei anzeigen, indem Sie die entsprechende Eigenschaft festlegen. In der folgenden Tabelle sind die Eigenschaften für die Angabe des XML‑Dokuments aufgelistet.

Sie können optional ein XSL‑Transformationsdokument angeben, das das XML‑Dokument formatiert, bevor es in den Ausgabestream geschrieben wird, indem Sie eine von zwei Eigenschaften festlegen. Diese beiden Eigenschaften stellen die unterschiedlichen Typen von XSL‑Transformationsdokumenten dar, die zum Formatieren des XML‑Dokuments verwendet werden können. Sie können das XML-Dokument entweder mit XslTransform oder mit einer XSL-Transformationsdatei formatieren, indem Sie die entsprechende Eigenschaft festlegen. Wenn kein XSL‑Transformationsdokument angegeben ist, wird das XML‑Dokument unter Verwendung des Standardformats angezeigt. In der folgenden Tabelle sind die Eigenschaften für die Angabe eines XSL‑Transformationsdokuments aufgelistet.

Die Xml-Klasse stellt außerdem die TransformArgumentList-Eigenschaft bereit, mit der Sie optionale Argumente für die XSL-Transformation bereitstellen können. Die Argumente können entweder XSLT-Parameter oder Erweiterungsobjekte sein.

Beispiel

Im Folgenden ein Beispiel für eine XML‑Datei.

<People>
   <Person>
      <Name>
         <FirstName>Joe</FirstName>
         <LastName>Suits</LastName>
      </Name>
      <Address>
         <Street>1800 Success Way</Street>
         <City>Redmond</City>
         <State>WA</State>
         <ZipCode>98052</ZipCode>
      </Address>
      <Job>
         <Title>CEO</Title>
         <Description>Wears the nice suit</Description>
      </Job>
   </Person>

   <Person>
      <Name>
         <FirstName>Linda</FirstName>
         <LastName>Sue</LastName>
      </Name>
      <Address>
         <Street>1302 American St.</Street>
         <City>Paso Robles</City>
         <State>CA</State>
         <ZipCode>93447</ZipCode>
      </Address>
      <Job>
         <Title>Attorney</Title>
         <Description>Stands up for justice</Description>
      </Job>
   </Person>

   <Person>
      <Name>
         <FirstName>Jeremy</FirstName>
         <LastName>Boards</LastName>
      </Name>
      <Address>
         <Street>34 Palm Avenue</Street>
         <City>Waikiki</City>
         <State>HI</State>
         <ZipCode>98052</ZipCode>
      </Address>
      <Job>
         <Title>Pro Surfer</Title>
         <Description>Rides the big waves</Description>
      </Job>
   </Person>

   <Person>
      <Name>
         <FirstName>Joan</FirstName>
         <LastName>Page</LastName>
      </Name>
      <Address>
         <Street>700 Webmaster Road</Street>
         <City>Redmond</City>
         <State>WA</State>
         <ZipCode>98073</ZipCode>
      </Address>
      <Job>
         <Title>Web Site Developer</Title>
         <Description>Writes the pretty pages</Description>
      </Job>
   </Person>
</People>

Im Folgenden ein Beispiel für eine XSL‑Transformationsdatei.

<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
   <xsl:template match="/People">
      <xsl:apply-templates select="Person" />
   </xsl:template>
  
   <xsl:template match="Person">
      <table width="100%" border="1">
         <tr>
            <td>
               <b>
                  <xsl:value-of select="Name/FirstName" />
                  &#160;
                  <xsl:value-of select="Name/LastName" />
               </b>
            </td>
         </tr>
         <tr>
            <td>
               <xsl:value-of select="Address/Street" /><br />
               <xsl:value-of select="Address/City" />
               , 
               <xsl:value-of select="Address/State" /> 
               <xsl:value-of select="Address/Zip" />
            </td>
         </tr>
         <tr>
            <td>
               Job Title: <xsl:value-of select="Job/Title" /><br />
               Description: <xsl:value-of select="Job/Description" />
            </td>
         </tr>
      </table>

   </xsl:template>

   <xsl:template match="bookstore">
      <!-- Prices and books -->
      <bookstore>
         <xsl:apply-templates select="book"/>
      </bookstore>
   </xsl:template>

   <xsl:template match="book">
      <book>
         <xsl:attribute name="ISBN">
            <xsl:value-of select="@ISBN"/>
         </xsl:attribute>
         <price>
            <xsl:value-of select="price"/>
         </price>
         <xsl:text>
         </xsl:text>
      </book>
   </xsl:template>

</xsl:stylesheet>

Das folgende Beispiel veranschaulicht, wie mit dem Xml-Steuerelement die Beispiel-XML-Datei unter Verwendung der Beispiel-XSL-Transformationsdatei angezeigt werden kann. Die Beispiel-XML-Datei muss People.xml heißen, die Beispiel-XSL-Transformationsdatei Peopletable.xsl.

<html>
<body>
   <h3>Xml Example</h3>
   <form runat="server">
      <asp:Xml id="xml1" 
           DocumentSource="people.xml" 
           TransformSource="peopletable.xsl" 
           runat="server" />
   </form>
</body>
</html>

Das folgende Beispiel veranschaulicht, wie aus der Beispiel-XML-Datei und der Beispiel-XSL-Transformationsdatei ein XmlDocument-Objekt und ein XslTransform-Objekt erstellt werden. Die Objekte werden anschließend vom Xml-Steuerelement dazu verwendet, das XML-Dokument anzuzeigen. Die Beispiel-XML-Datei muss People.xml heißen, die Beispiel-XSL-Transformationsdatei Peopletable.xsl.

<%@ Page Language="VB" AutoEventWireup="True" %>
<%@ Import Namespace="System.Xml" %>
<%@ Import Namespace="System.Xml.Xsl" %>
<html>
   <script runat="server">
      Sub Page_Load(sender As Object, e As EventArgs)
         Dim doc As XmlDocument = New XmlDocument()
         doc.Load(Server.MapPath("people.xml"))

         Dim trans As XslTransform = new XslTransform()
         trans.Load(Server.MapPath("peopletable.xsl"))

         xml1.Document = doc
         xml1.Transform = trans
      End Sub
</script>
<body>
   <h3>Xml Example</h3>
   <form runat="server">
      <asp:Xml id="xml1" runat="server" />
   </form>
</body>
</html>

<%@ Page Language="C#" AutoEventWireup="True" %>
<%@ Import Namespace="System.Xml" %>
<%@ Import Namespace="System.Xml.Xsl" %>
<html>
   <script runat="server">
      void Page_Load(Object sender, EventArgs e) 
      {
         XmlDocument doc = new XmlDocument();
         doc.Load(Server.MapPath("people.xml"));

         XslTransform trans = new XslTransform();
         trans.Load(Server.MapPath("peopletable.xsl"));

         xml1.Document = doc;
         xml1.Transform = trans;
      }
   </script>
<body>
   <h3>Xml Example</h3>
      <form runat="server">
         <asp:Xml id="xml1" runat="server" />
      </form>
</body>
</html>

Siehe auch

Referenz

Xml

Weitere Ressourcen

Syntax des Webserversteuerelements