XML controle de servidor Web Declarative sintaxe
Exibe um documento XML ou os resultados de uma transformação XSL.
<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"
/>
Comentários
Use o Xml controle para exibir o Sumário de um documento XML ou os resultados de uma transformação XSL.
O documento XML para exibir é especificado pelo configuração um dos três propriedades. Essas três propriedades representam os diferentes tipos de documentos XML que podem ser exibidos. Você pode exibir um XmlDocument, uma sequência XML ou um arquivo XML, definindo a propriedade apropriada. A tabela a seguir lista as propriedades para especificar o documento XML.
Propriedade |
Descrição |
|---|---|
Define o documento XML usando um XmlDocument objeto. |
|
Define o documento XML usando uma seqüência de caracteres. .gif "Observação") Observação:
Esta propriedade é normalmente conjunto declarativamente, colocando o texto entre a abertura e fechamento <asp:Xml> Rótulos da Xml controle.
|
|
Define o documento XML usando um arquivo. |
| Observação: |
|---|
Pelo menos uma das propriedades do documento XML deve ser definida ou nenhum documento XML é exibido. Se mais de uma propriedade de documento XML for definida, o documento XML no último conjunto de propriedades será exibido. Os documentos nas outras propriedades são ignorados. |
Opcionalmente, você pode especificar um documento de transformação XSL que formata o documento XML antes que elas sejam gravados no fluxo de saída por configuração uma das duas propriedades. As duas propriedades representam os tipos diferentes de documentos de transformação XSL que podem ser usados para formatar o documento XML. Você pode formatar o documento XML com um XslTransform ou com uma transformação XSL arquivo definindo a propriedade apropriada. Se nenhum documento transformação XSL for especificado, o documento XML será exibido usando o formato padrão. A tabela a seguir lista as propriedades para especificar um documento de transformação XSL.
Propriedade |
Descrição |
|---|---|
Formata o documento XML usando o especificadoXslTransform. |
|
Formata o documento XML usando o arquivo de transformação XSL especificado. |
| Observação: |
|---|
O documento de transformação XSL é opcional. Você não precisa conjunto a Transform ou o TransformSource Propriedades. Se ambas as propriedades do documento de transformação XSL estiverem definidas, o último conjunto de propriedades determina qual documento transformação XSL é usado para formatar o documento XML. A Outros propriedade será ignorada. |
The Xml classe também fornece o TransformArgumentList propriedade, que permite que você forneça a transformação XSL com argumentos opcionais. Os argumentos podem ser parâmetros XSLT ou objetos de extensão.
Exemplo
O seguir mostra um arquivo XML de exemplo.
<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>
A seguir mostra um arquivo de transformação XSL de exemplo.
<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>
O exemplo a seguir demonstra como usar o Xml controle para exibir o arquivo XML de exemplo usando o arquivo de transformação XSL de exemplo. Certifique-se de que o arquivo XML de exemplo é chamado People.XML e o arquivo de transformação XSL de exemplo é chamado 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>
O exemplo a seguir demonstra como criar XmlDocument e XslTransform objetos de arquivos XML e transformação XSL de exemplo. Os objetos são usados pelo Xml controle para exibir o documento XML. Certifique-se de que o arquivo XML de exemplo é chamado People.XML e o arquivo de transformação XSL de exemplo é chamado 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>