Vue d'ensemble du contrôle serveur Web XML

Article
10/22/2014

Mise à jour : novembre 2007

Vous pouvez utiliser le contrôle serveur Web Xml pour afficher le contenu d'un document XML sans mise en forme, ou utiliser des transformations XSL.

Cette rubrique contient les sections suivantes :

Scénarios
Contexte
Exemples de code
Référence de classe

Scénarios

Un contrôle serveur Web Xml lit les données XML et les écrit dans une page Web ASP.NET à l'emplacement du contrôle. Si une transformation XSL (XSLT) est appliquée dans le XML, la transformation obtenue sera rendue dans la page.

Retour au début

Contexte

Vous pouvez utiliser le contrôle serveur Web XML pour écrire un document XML ou les résultats d'une transformation XSLT dans une page Web ASP.ENT. La sortie XML apparaît dans la page Web à l'emplacement du contrôle.

Remarque :
Pour utiliser des données XML comme source d'autres contrôles, tels que les contrôles Repeater, DataList ou GridView, vous pouvez utiliser le contrôle XmlDataSource. Pour plus d'informations, consultez Vue d'ensemble du contrôle serveur Web XmlDataSource.

Les informations XML et XSLT peuvent se trouver dans des documents externes. Vous pouvez également les inclure dans la page. Il existe deux façons de faire référence à des documents externes en utilisant les paramètres de propriété dans le contrôle serveur Web XML. Vous pouvez spécifier un chemin d'accès au document XML dans la balise du contrôle, ou vous pouvez charger par programme les documents XML et XSLT en tant qu'objets puis les passer au contrôle. Si vous préférez inclure les informations XML dans la page, écrivez-les entre les balises d'ouverture et de fermeture du contrôle.

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

Propriété	Description
Document	Définit le document XML en utilisant un objet System.Xml.XmlDocument.
DocumentContent	Définit le document XML en utilisant une chaîne. Remarque : Cette propriété est généralement définie de façon déclarative, en plaçant le texte entre les balises d'ouverture et de fermeture <asp:Xml> du contrôle Xml.
DocumentSource	Définit le document XML en utilisant un fichier.

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, c'est le document XML référencé dans la dernière propriété définie qui s'affiche. Les documents des autres propriétés sont ignorés.

Vous pouvez également définir des propriétés pour 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. Les 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 un 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é en utilisant le format par défaut.

Retour au début