Questa documentazione è stata archiviata e non viene gestita.

Classe Xml

Aggiornamento: novembre 2007

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)

[AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level = AspNetHostingPermissionLevel.Minimal)]
[AspNetHostingPermissionAttribute(SecurityAction.InheritanceDemand, Level = AspNetHostingPermissionLevel.Minimal)]
public class Xml : Control
/** @attribute AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level = AspNetHostingPermissionLevel.Minimal) */
/** @attribute AspNetHostingPermissionAttribute(SecurityAction.InheritanceDemand, Level = AspNetHostingPermissionLevel.Minimal) */
public class Xml extends Control
public class Xml extends Control
<asp:Xml />

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.

Nota:

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.

Nota:

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.

Nota:

L'utilizzo di un oggetto System.Xml.Xsl.XslTransform richiede autorizzazioni Full Trust.

TransformSource

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

Nota:

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.

TopicLocation
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" %>
<!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" >
   <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>
<head runat="server">
    <title>Xml Class Example</title>
</head>
<body>
   <h3>Xml Example</h3>
      <form id="form1" 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.

<?xml version="1.0" encoding="utf-8"?>

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

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

<?xml version="1.0" encoding="utf-8" ?>
<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>

-->


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

Qualsiasi membro static (Shared in Visual Basic) pubblico di questo tipo è thread-safe. I membri di istanza non sono garantiti come thread-safe.

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition , Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.

.NET Framework

Supportato in: 3.5, 3.0, 2.0, 1.1, 1.0
Mostra: