Langage de programmation - ASP.NET - Balises

ASP:XML	ASP : XML
ASP.NET	Framework .NET 2+

Syntaxe

<asp:Xml paramètres>
</asp:Xml >

Paramètres

Paramètre	Description
DocumentSource=uri	Ce paramètre permet d'indiquer l'emplacement du fichier source de XML.
EnableTheming=valeur	Ce paramètre permet d'indiquer si le thème de la balise doit être affiché ou non :
	Constante	Description
	"False"	Cette constante permet d'indiquer que le thème de la balise n'est pas affiché.
	"True"	Cette constante permet d'indiquer que le thème de la balise est affiché.
EnableViewState=valeur	Ce paramètre permet d'indiquer si le ViewState de la balise doit être activé ou non :
	Constante	Description
	"False"	Cette constante permet d'indiquer que le ViewState de la balise n'est pas actif.
	"True"	Cette constante permet d'indiquer que le ViewState de la balise est actif.
ID=valeur	Ce paramètre permet d'indiquer l'identificateur de la balise.
OnDataBinding=valeur	Ce paramètre permet d'indiquer le gestionnaire d'événement de DataBinding.
OnDisposed=valeur	Ce paramètre permet d'indiquer le gestionnaire d'événement de disposition.
OnInit=valeur	Ce paramètre permet d'indiquer le gestionnaire d'événement d'initialisation.
OnLoad=valeur	Ce paramètre permet d'indiquer le gestionnaire d'événement de chargement.
OnPreRender=valeur	Ce paramètre permet d'indiquer le gestionnaire d'événement de pré-rendu.
OnUnload=valeur	Ce paramètre permet d'indiquer le gestionnaire d'événement de déchargement.
runat=valeur	Ce paramètre permet d'indiquer où doit être exécuté la balise :
	Constante	Description
	"server"	Cette constante permet d'indiquer qu'il faut exécuter la balise du côté serveur.
SkinID=valeur	Ce paramètre permet d'indiquer l'identificateur de Skin.
TransformSource=valeur	Ce paramètre de balise permet d'indiquer le type de transformation qu'il faut faire effectuer au XML.
Visible=valeur	Ce paramètre permet d'indiquer si la balise doit être affiché ou non :
	Constante	Description
	"False"	Cette constante permet d'indiquer que la balise n'est pas affiché.
	"True"	Cette constante permet d'indiquer que la balise est affiché.

Description

Cette balise permet d'inclure un fichier XML à la page.

Remarques

La balise <asp:Xml> permet d'afficher directement du contenu XML dans une page ASP.NET. Elle est particulièrement utile lorsqu'on veut visualiser des données issues d'un fichier XML ou d'une source XML dynamique.
Ce contrôle serveur est conçu pour rendre du XML brut ou transformé. Il peut afficher le contenu tel quel ou appliquer une feuille de style XSLT (XSL Transformations) pour le rendre lisible et stylisé en HTML.
Le paramètre DocumentSource peut être utilisé pour spécifier l'URL ou le chemin d'un fichier XML externe. Le contenu est alors automatiquement chargé et affiché à l'endroit de la balise.
On peut également charger le contenu XML dynamiquement dans le code-behind via la propriété Document, acceptant un objet XmlDocument. Cela permet une plus grande souplesse de traitement.
Grâce à la propriété TransformSource, on peut appliquer une feuille XSL externe afin de transformer le XML en HTML ou dans un autre format de présentation. Cela facilite la séparation contenu/présentation.
La balise <asp:Xml> n'affiche rien par défaut si aucune transformation n'est spécifiée. Il faut donc soit l'accompagner d'une feuille XSLT, soit s'assurer que le contenu XML est bien formé pour un rendu brut.
Lorsque le XML affiché contient des nouds complexes, la transformation XSL devient essentielle pour contrôler ce qui est affiché et dans quel ordre. Cela permet de présenter les données sous forme de tableau, liste,...
La propriété Transform permet d'assigner directement un objet XslTransform dans le code-behind. Cela permet d'utiliser des transformations complexes, dynamiques ou chargées à partir d'une base de données.
Le contrôle <asp:Xml> peut être stylisé comme n'importe quel autre composante WebForms, en utilisant les propriétés CSS, Font, ForeColor, BackColor,..., pour rendre la sortie plus lisible.
Il est possible de lier ce contrôle à une source de données XML via un XmlDataSource, ce qui facilite le couplage entre le backend XML et le frontend. Cela rend l'affichage plus fluide et automatisé.
Le contenu XML affiché peut provenir d'un fichier statique, d'une requête Web, ou d'un flux généré dynamiquement à partir d'une base de données ou d'un service web, ce qui le rend très polyvalent.
En environnement sécurisé, il faut être prudent avec les transformations XSLT si la source XML peut contenir du code malveillant. Il est conseillé de valider le XML en amont et de restreindre les extensions XSLT.
Le contrôle <asp:Xml> fonctionne uniquement côté serveur. Cela signifie que tout traitement ou transformation a lieu sur le serveur avant que le contenu transformé soit rendu côté client.
Ce contrôle est utile pour les développeurs souhaitant afficher des rapports XML ou des données issues d'échanges B2B dans une interface Web, sans devoir analyser manuellement le XML dans le code.
L'utilisation du contrôle <asp:Xml> permet aussi de tester facilement l'intégration de flux XML (comme RSS, Atom,...) dans des interfaces Web, avec un rendu immédiat et contrôlé.

Exemple

Prenons pour acquis que le fichier de données suivant «donnes.xml» :


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

<MaListe>

  <Site>

    <NavigateUrl>http://www.gladir.com</NavigateUrl>

    <AlternateText>Gladir international</AlternateText>

  </Site>

  <Site>

    <NavigateUrl>http://www.gladir.ca</NavigateUrl>

    <AlternateText>Gladir Canada</AlternateText>

  </Site>

</MaListe>

On pourra afficher le contenu du XML avec le code ASP.NET suivant :


	
				
<%@ Page Language="vb" %>

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

<head runat="server">

    <title></title>

</head>

<body>

    <form id="form1" runat="server">

    <div>

    <asp:Xml ID="XmlDonnee" runat="server" DocumentSource="~/donnees.xml" ></asp:Xml>

    </div>

    </form>

</body>

</html>

on obtiendra le résultat semblable suivant :

http://www.gladir.comGladir internationalhttp://www.gladir.caGladir Canada

Voir également

Articles - Les géants de l'informatique - Microsoft

Dernière mise à jour : Samedi, le 31 août 2017

Section courante

A propos

Section administrative du site

ASP:XML