Xml-Klasse
Zeigt ein XML-Dokument ohne Formatierung und ohne XSLT (Extensible Stylesheet Language Transformations) an.
Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)
Syntax
'Declaration
Public Class Xml
Inherits Control
'Usage
Dim instance As Xml
public class Xml : Control
public ref class Xml : public Control
public class Xml extends Control
public class Xml extends Control
Hinweise
Mit dem Xml-Steuerelement können Sie den Inhalt eines XML-Dokuments ohne Formatierung und ohne Verwendung von XSL-Transformationen anzeigen.
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. Durch Festlegen der entsprechenden Eigenschaft können Sie ein System.Xml.XmlDocument, eine XML-Zeichenfolge oder eine XML-Datei anzeigen. In der folgenden Tabelle sind die Eigenschaften für die Angabe des XML-Dokuments aufgelistet.
Eigenschaft |
Beschreibung |
|---|---|
Das XML-Dokument wird mit einem System.Xml.XmlDocument-Objekt festgelegt. |
|
Legt das XML-Dokument mit einer Zeichenfolge fest. Hinweis Diese Eigenschaft wird im allgemeinen deklarativ festgelegt, indem zwischen dem öffnenden und dem schließenden <asp:Xml>-Tag des Xml-Steuerelements Text eingefügt wird. |
|
Legt das XML-Dokument mit einer Datei fest. |
Hinweis
Für das Anzeigen eines XML-Dokuments muss mindestens eine der XML-Dokumenteigenschaften festgelegt sein. Wenn mehrere XML-Dokumenteigenschaften festgelegt sind, wird das XML-Dokument angezeigt, auf das in der zuletzt festgelegten Eigenschaft verwiesen wird. Die Dokumente in den anderen Eigenschaften werden dann ignoriert.
Sie können bei Bedarf ein XSL-Transformation-Stylesheet (XSLT) angeben, das das XML-Dokument vor dem Schreiben in den Ausgabestream formatiert, indem Sie eine von zwei Eigenschaften festlegen. Die beiden Eigenschaften stellen die verschiedenen Typen von XSL-Transformation-Stylesheet dar, mit denen das XML-Dokument formatiert werden kann. Sie können das XML-Dokument mit einem System.Xml.Xsl.XslCompiledTransform-Objekt oder mit einer XSL-Transformation-Stylesheetdatei formatieren, indem Sie die entsprechende Eigenschaft festlegen. Wenn kein XSL-Transformation-Stylesheet angegeben ist, wird das XML-Dokument mit dem Standardformat angezeigt. In der folgenden Tabelle werden die Eigenschaften aufgelistet, mit denen ein XSL-Transformation-Stylesheet angegeben wird.
Eigenschaft |
Beschreibung |
|---|---|
Formatiert das XML-Dokument mit dem angegebenen System.Xml.Xsl.XslTransform-Objekt. |
|
Formatiert das XML-Dokument mit der angegebenen XSL-Transformation-Stylesheetdatei. |
Hinweis
Das XSL-Transformation-Stylesheet ist optional. Die Transform-Eigenschaft oder die TransformSource-Eigenschaft muss nicht festgelegt werden. Wenn beide XSL-Transformation-Stylesheeteigenschaften festgelegt sind, bestimmt die zuletzt festgelegte Eigenschaft, welches XSL-Transformation-Stylesheet zum Formatieren des XML-Dokuments verwendet wird. Die andere Eigenschaft wird ignoriert.
Die Xml-Klasse stellt außerdem die TransformArgumentList-Eigenschaft bereit, mit der Sie für das XSL-Transformation-Stylesheet optionale Argumente bereitstellen können. Die Argumente können entweder XSLT-Parameter (XSL Transformations) oder Erweiterungsobjekte sein.
Beispiel
Im folgenden Codebeispiel wird das Erstellen eines XmlDocument-Objekts und eines XslTransform-Objekts aus einer XML-Beispieldatei und einem XSL-Transformation-Stylesheet veranschaulicht. Die Objekte werden anschließend vom XML-Steuerelement zum Anzeigen des XML-Dokuments verwendet.
<!--
The following example demonstrates how to create XmlDocument and
XslTransform objects from the sample XML and XSL Transform files.
The objects are then used by the Xml control to display the XML
document. Make sure the sample XML file is called People.xml and
the sample XSL Transform file is called 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>
<!--
For this example to work, paste the following code into a file
named peopletable.xsl. Store the file in the same directory as
your .aspx file.
<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" />
 
<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>
-->
<!--
For this example to work, paste the following code into a file
named people.xml. Store the file in the same directory as
your .aspx file.
<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>
-->
<!--
The following example demonstrates how to create XmlDocument and
XslTransform objects from the sample XML and XSL Transform files.
The objects are then used by the Xml control to display the XML
document. Make sure the sample XML file is called People.xml and
the sample XSL Transform file is called Peopletable.xsl.
-->
<%@ 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>
<!--
For this example to work, paste the following code into a file
named peopletable.xsl. Store the file in the same directory as
your .aspx file.
<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" />
 
<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>
-->
<!--
For this example to work, paste the following code into a file
named people.xml. Store the file in the same directory as
your .aspx file.
<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>
-->
.NET Framework-Sicherheit
- AspNetHostingPermission für den Betrieb in einer Hostumgebung. Anforderungswert: LinkDemand, Berechtigungswert: Minimal
- AspNetHostingPermission für den Betrieb in einer Hostumgebung. Anforderungswert: InheritanceDemand, Berechtigungswert: Minimal
Vererbungshierarchie
System.Object
System.Web.UI.Control
System.Web.UI.WebControls.Xml
Threadsicherheit
Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.
Plattformen
Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
Siehe auch
Referenz
Xml-Member
System.Web.UI.WebControls-Namespace
System.Xml.XmlDocument
System.Xml.Xsl.XslTransform
Document
DocumentContent
DocumentSource
TransformArgumentList