Exporter (0) Imprimer
Développer tout

Xml, classe

Affiche un document XML sans mise en forme ou utilisation des transformations XSL (Extensible Stylesheet Language Transformations).

Espace de noms : System.Web.UI.WebControls
Assembly : System.Web (dans system.web.dll)

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

Utilisez le contrôle Xml pour afficher le contenu d'un document XML sans mise en forme ou utilisation des transformations XSL.

Le document XML à afficher est spécifié en définissant l'une des trois propriétés disponibles. Ces trois propriétés représentent les différents types de documents XML qui peuvent être affichés. Vous pouvez afficher un objet System.Xml.XmlDocument, une chaîne XML ou un fichier XML en définissant la propriété appropriée. Le tableau suivant répertorie les propriétés possibles pour spécifier le document XML.

Propriété

Description

Document

Définit le document XML à l'aide d'un objet System.Xml.XmlDocument.

DocumentContent

Définit le document XML à l'aide d'une chaîne.

RemarqueRemarque

Cette propriété est couramment définie de manière déclarative en plaçant du texte entre les balises d'ouverture et de fermeture <asp:Xml> du contrôle Xml.

DocumentSource

Définit le document XML à l'aide d'un fichier.

RemarqueRemarque

Au moins une des propriétés de document XML doit être définie pour afficher un document XML. Si plusieurs propriétés de document XML sont définies, le document XML référencé dans la dernière propriété définie est affiché. Les documents référencés dans les autres propriétés sont ignorés.

Vous pouvez, si vous le souhaitez, spécifier une feuille de style de transformation XSL (XSLT), qui met en forme le document XML avant qu'il soit écrit dans le flux de sortie, en définissant l'une des deux propriétés disponibles. Les deux propriétés représentent les différents types de feuilles de style de transformation XSL qui peuvent être utilisées pour mettre en forme le document XML. Vous pouvez mettre en forme le document XML avec un objet System.Xml.Xsl.XslCompiledTransform ou avec un fichier de feuille de style de transformation XSL en définissant la propriété appropriée. Si aucune feuille de style de transformation XSL n'est spécifiée, le document XML est affiché avec le format par défaut. Le tableau suivant répertorie les propriétés utilisées pour spécifier une feuille de style de transformation XSL.

Propriété

Description

Transform

Met en forme le document XML à l'aide de l'objet System.Xml.Xsl.XslTransform spécifié.

TransformSource

Met en forme le document XML à l'aide du fichier de feuille de style de transformation XSL spécifié.

RemarqueRemarque

La feuille de style de transformation XSL est facultative. Il est inutile de définir la propriété Transform ou TransformSource. Si les deux propriétés de feuille de style de transformation XSL sont définies, la dernière propriété définie détermine la feuille de style de transformation XSL utilisée pour mettre en forme le document XML. L'autre propriété est ignorée.

La classe Xml fournit également la propriété TransformArgumentList qui vous permet de spécifier des arguments facultatifs pour la feuille de style de transformation XSL. Ces arguments peuvent être des paramètres de transformation XSL (XSLT) ou des objets d'extension.

RubriqueEmplacement
Comment : charger des données XML dans le contrôle serveur Web XMLGénération d'applications Web ASP.NET
Comment : transformer des données XML dans le contrôle serveur Web XMLGénération d'applications Web ASP.NET
Procédure pas à pas : création d'une page Web pour afficher des données XMLGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : affichage d'un document XML dans une page Web Forms à l'aide des transformationsGénération d'applications Web ASP.NET dans Visual Studio
Comment : ajouter des contrôles serveur Web XML à une page Web Forms (Visual Studio)Génération d'applications Web ASP.NET dans Visual Studio
Comment : ajouter des contrôles serveur Web XML à une page Web FormsGénération d'applications Web ASP.NET
Comment : ajouter des contrôles serveur Web XML à une page Web Forms (Visual Studio)Génération d'applications Web ASP.NET dans Visual Studio
Comment : charger des données XML dans le contrôle serveur Web XMLGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : création d'une page Web pour afficher des données XMLGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : affichage d'un document XML dans une page Web Forms à l'aide des transformationsGénération d'applications Web ASP.NET dans Visual Studio
Comment : transformer des données XML dans le contrôle serveur Web XMLGénération d'applications Web ASP.NET dans Visual Studio

L'exemple de code suivant indique comment créer des objets XmlDocument et XslTransform à partir d'un fichier d'exemple XML et d'une feuille de style de transformation XSL. Les objets sont ensuite utilisés par le contrôle XML pour afficher le document 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  pour opérer dans un environnement hébergé. Valeur de demande : LinkDemand ; valeur d'autorisation : Minimal
  • AspNetHostingPermission  pour opérer dans un environnement hébergé. Valeur de demande : InheritanceDemand ; valeur d'autorisation : Minimal

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

Les membres statiques publics (Shared en Visual Basic) de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

Prise en charge dans : 2.0, 1.1, 1.0

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft