Configurer la source de données, boîte de dialogue - XmlDataSource

Article
08/21/2008

Mise à jour : novembre 2007

La boîte de dialogue Configurer la source de données - XmlDataSource vous permet de configurer une source de données XML lorsque vous souhaitez afficher des données XML dans un contrôle serveur Web ASP.NET qui prend en charge la liaison de données. Le titre de la boîte de dialogue change en fonction de l'ID du contrôle de source de données.

Vous pouvez utiliser une source de données XML pour afficher des données hiérarchiques et sous forme de tableau, bien qu'elle soit utilisée en général pour afficher des données XML hiérarchiques dans des scénarios en lecture seule.

Note de sécurité :
Si vous stockez des données dans un fichier XML, vous devez enregistrer ce fichier dans le dossier App_Data de votre site Web, car le contenu de ce dossier n'est pas retourné aux demandes HTTP directes. Pour plus d'informations, consultez Sécurisation de l'accès aux données.

Les contrôles serveur Web qui prennent en charge la liaison de données sont entre autres les suivants :

BulletedList	DetailsView	GridView	RadioButtonList
CheckBoxList	DropDownList	ListBox	Repeater
DataList	FormView	Menu	TreeView

Pour accéder à cette boîte de dialogue à partir d'un contrôle serveur Web ASP.NET

Dans Visual Web Developer, ouvrez une page ASPX.
Basculez en mode Design.
À partir de la Boîte à outils, faites glisser l'un des contrôles de la liste précédente sur la page. Par exemple, à partir du groupe Standard de la Boîte à outils, faites glisser un contrôle ListBox sur la page.
Cliquez avec le bouton droit sur le contrôle, puis cliquez sur Afficher la balise active.

Dans la fenêtre de tâches qui s'affiche, dans la liste déroulante Choisir la source de données, sélectionnez <Nouvelle source de données…>.

Remarque :
Certains contrôles vous permettent uniquement de cliquer sur Choisir la source de données, après quoi vous sélectionnez Nouvelle source de données… dans la liste déroulante Sélectionnez une source de données.

L'Assistant Configuration de source de données s'ouvre.

Sous À partir d'où l'application obtiendra-t-elle les données ?, cliquez sur Fichier XML.
Dans la zone Spécifiez un ID pour la source de données, tapez un ID de source de données.

L'ID par défaut est XmlDataSource1.
Cliquez sur OK.

Un contrôle XmlDataSource est créé automatiquement sur votre page et la fenêtre Configurer la source de données - XmlDataSource1 s'ouvre.

Pour accéder directement à cette boîte de dialogue à partir d'un contrôle XmlDataSource

Dans Visual Web Developer, ouvrez une page ASPX.
Basculez en mode Design.
À partir du groupe Données de la Boîte à outils, faites glisser un contrôle XmlDataSource sur la page.
Dans la fenêtre de tâches, cliquez sur Configurer la source de données.

La fenêtre Configurer la source de données - XmlDataSource1 s'ouvre.

Après avoir configuré le contrôle XmlDataSource, vous pouvez le lier à l'un des contrôles serveur Web dans la liste ci-dessus en spécifiant l'ID de source de données dans la liste déroulante Choisir la source de données ou dans la propriété DataSourceID du contrôle serveur Web.

Pour plus d'informations sur la liaison de données, consultez Vue d'ensemble de l'accès aux données ASP.NET ou les rubriques orientées tâche suivantes.

Tâches

Procédure pas à pas : création d'une page Web pour afficher des données XML

Procédure pas à pas : affichage de données hiérarchiques dans un contrôle TreeView

Comment : établir une liaison vers les données d'un contrôle basé sur des modèles dans Visual Studio

Comment : sécuriser des chaînes de connexion lors de l'utilisation de contrôles de source de données

Comment : établir une liaison vers les données d'un contrôle basé sur des modèles

Éléments d'interface

Fichier de données
Spécifie le chemin d'accès relatif à un fichier de données XML à utiliser en tant que source pour ce contrôle. Si vous stockez votre fichier XML dans le dossier App_Data, le format du chemin d'accès relatif devrait se présenter comme suit :

~/App_Data/exampleXmlDataFile.xml
Fichier de transformation
Spécifie le chemin d'accès relatif à un fichier de transformation facultatif qui décrit comment la structure du fichier XML doit être convertie en une structure différente. Si vous stockez votre fichier XML dans le dossier App_Data, le format du chemin d'accès relatif devrait se présenter comme suit :

~/App_Data/exampleTransformFile.xml
Expression XPath
Spécifie une expression XPath facultative qui vous permet de filtrer les données dans le fichier XML afin de retourner un sous-ensemble du fichier. Un XPath utilise le format suivant, où un nombre quelconque de niveaux d'éléments enfants peut être spécifié :

/rootElementName/childElementName

Si une expression XPath est spécifiée, seules les données du niveau de l'élément spécifié et du niveau inférieur sont retournées.