Questa documentazione è stata archiviata e non viene gestita.

Classe Xml

Visualizza un documento XML senza formattarlo o utilizzare XSLT (Extensible Stylesheet Language Transformation).

Spazio dei nomi: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)

public class Xml : Control
public class Xml extends Control
public class Xml extends Control

Utilizzare il controllo Xml per visualizzare il contenuto di un documento XML senza formattarlo o applicarvi le trasformazioni XSL.

Il documento XML da visualizzare viene specificato impostando una delle tre proprietà disponibili. Le tre proprietà rappresentano i diversi tipi di documenti XML che possono essere visualizzati. È possibile visualizzare un oggetto System.Xml.XmlDocument, una stringa XML o un file XML impostando la proprietà appropriata. Nella tabella che segue sono elencate le proprietà per specificare il documento XML.

Proprietà

Descrizione

Document

Imposta il documento XML utilizzando un oggetto System.Xml.XmlDocument.

DocumentContent

Imposta il documento XML utilizzando una stringa.

NotaNota

Questa proprietà viene in genere impostata a livello di dichiarazione, inserendo il testo tra i tag <asp:Xml> di apertura e di chiusura del controllo Xml.

DocumentSource

Imposta il documento XML utilizzando un file.

NotaNota

Almeno una delle proprietà del documento XML deve essere impostata in modo da determinare la visualizzazione di un documento XML. Se sono impostate più proprietà del documento XML, viene visualizzato il documento al quale fa riferimento l'ultima proprietà impostata. I documenti ai quali si fa riferimento nelle altre proprietà vengono ignorati.

Se lo si desidera, è possibile specificare un foglio di stile per la trasformazione XSL (XSLT) in base al quale formattare il documento prima che venga scritto nel flusso di output impostando una delle due proprietà indicate di seguito. Le due proprietà rappresentano i due tipi di foglio di stile per la trasformazione XSL che è possibile utilizzare per formattare il documento XML. È possibile formattare il documento XML tramite un oggetto System.Xml.Xsl.XslCompiledTransform o un file del foglio di stile per la trasformazione XSL impostando la proprietà appropriata. Se non è specificato alcun foglio di stile per la trasformazione XSL, il documento XML viene visualizzato utilizzando il formato predefinito. Nella tabella riportata di seguito sono elencate le proprietà per specificare un foglio di stile per la trasformazione XSL.

Proprietà

Descrizione

Transform

Formatta il documento XML utilizzando l'oggetto System.Xml.Xsl.XslTransform specificato.

TransformSource

Formatta il documento XML utilizzando il foglio di stile per la trasformazione XSL specificato.

NotaNota

Il foglio di stile per la trasformazione XSL è facoltativo. Non è necessario impostare le proprietà Transform o TransformSource. Se entrambe le proprietà del foglio di stile di trasformazione XSL sono impostate, l'ultima proprietà impostata determina quale foglio di stile di trasformazione XSL verrà utilizzato per formattare il documento XML. L'altra proprietà sarà ignorata.

La classe Xml fornisce inoltre la proprietà TransformArgumentList, che consente di aggiungere argomenti facoltativi al foglio di stile per la trasformazione XSL. Gli argomenti possono essere parametri delle trasformazioni XSL (XSLT) oppure oggetti estensione.

ArgomentoPercorso
Procedura dettagliata: creazione di una pagina Web per visualizzare dati XMLGenerazione di applicazioni Web ASP.NET in Visual Studio
Procedura dettagliata: visualizzazione di un documento XML in una pagina Web Form mediante trasformazioniGenerazione di applicazioni Web ASP.NET in Visual Studio
Procedura: aggiungere controlli server Web XML a una pagina Web Form (Visual Studio)Generazione di applicazioni Web ASP.NET in Visual Studio
Procedura: aggiungere controlli server Web XML a una pagina Web Form (Visual Studio)Compilazione di applicazioni Web ASP.NET in Visual Studio
Procedura: caricare dati XML nel controllo server Web XMLCompilazione di applicazioni Web ASP.NET in Visual Studio
Procedura dettagliata: creazione di una pagina Web per visualizzare dati XMLCompilazione di applicazioni Web ASP.NET in Visual Studio
Procedura dettagliata: visualizzazione di un documento XML in una pagina Web Form mediante trasformazioniCompilazione di applicazioni Web ASP.NET in Visual Studio
Procedura: trasformare i dati XML nel controllo server Web XMLCompilazione di applicazioni Web ASP.NET in Visual Studio
Procedura: aggiungere controlli server Web XML a una pagina Web FormGenerazione di applicazioni Web ASP.NET
Procedura: caricare dati XML nel controllo server Web XMLGenerazione di applicazioni Web ASP.NET
Procedura: trasformare i dati XML nel controllo server Web XMLGenerazione di applicazioni Web ASP.NET
Procedura: aggiungere controlli server Web XML a una pagina Web Form (Visual Studio)Compilazione di applicazioni Web ASP.NET in Visual Studio
Procedura: caricare dati XML nel controllo server Web XMLCompilazione di applicazioni Web ASP.NET in Visual Studio
Procedura dettagliata: creazione di una pagina Web per visualizzare dati XMLCompilazione di applicazioni Web ASP.NET in Visual Studio
Procedura dettagliata: visualizzazione di un documento XML in una pagina Web Form mediante trasformazioniCompilazione di applicazioni Web ASP.NET in Visual Studio
Procedura: trasformare i dati XML nel controllo server Web XMLCompilazione di applicazioni Web ASP.NET in Visual Studio

Nell'esempio di codice riportato di seguito viene illustrato come creare oggetti XmlDocument e XslTransform da un file XML di esempio e da un foglio di stile per la trasformazione XSL. Successivamente, gli oggetti sono utilizzati dal controllo XML per visualizzare il documento XML.

<!-- 
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" />
                  &#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>


-->

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

-->

  • AspNetHostingPermission  per operare in un ambiente host. Valore richiesta: LinkDemand. Valore autorizzazione: Minimal.
  • AspNetHostingPermission  per operare in un ambiente host. Valore richiesta: InheritanceDemand. Valore autorizzazione: Minimal.

System.Object
   System.Web.UI.Control
    System.Web.UI.WebControls.Xml

I membri statici pubblici (Shared in Visual Basic) di questo tipo sono validi per le operazioni multithreading. I membri di istanza non sono garantiti come thread safe.

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 non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema.

.NET Framework

Supportato in: 2.0 1.1 1.0
Mostra: