Comment : ajouter et supprimer des références Web

Article
10/22/2014

Mise à jour : novembre 2007

Une référence Web permet qu'un projet utilise un ou plusieurs services Web XML. Utilisez la Ajouter une référence Web, boîte de dialogue pour rechercher des services Web localement, sur un réseau local ou sur Internet.

Après avoir ajouté une référence Web à votre projet en cours, vous pouvez appeler toute méthode exposée par le service Web. Pour plus d'informations, consultez Comment : appeler un service Web.

Pour plus d'informations sur la création d'une classe de service Web, consultez Procédure pas à pas : création d'un service Web XML de base à l'aide d'ASP.NET.

Pour ajouter une référence Web à un projet

Dans l'Explorateur de solutions, cliquez avec le bouton droit sur le nom du projet auquel vous voulez ajouter le service Web, puis cliquez sur Ajouter une référence Web.

La boîte de dialogue Ajouter une référence Web s'affiche.

Dans la zone URL, entrez l'URL du service Web à utiliser. Si vous ne connaissez pas l'URL, utilisez les liens dans le volet du navigateur pour localiser le service Web voulu.

Remarque :
Si vous développez une application Web sur un ordinateur se trouvant derrière un pare-feu et si votre application doit utiliser des services Web situés en dehors de ce pare-feu, vous devez inclure dans l'URL l'adresse et le port du serveur proxy de votre réseau. Demandez à votre administrateur réseau de vous fournir cette partie du chemin d'accès de l'URL. Pour plus d'informations, consultez « Les paramètres du proxy ne sont pas correctement configurés sur cet ordinateur pour la découverte Web » dans le Kit de développement Visual Studio 2005 SDK.

Si vous développez une application Web sur un ordinateur se trouvant derrière un pare-feu et si votre application doit utiliser des services Web situés en dehors de ce pare-feu, vous devez inclure dans l'URL l'adresse et le port du serveur proxy de votre réseau. Demandez à votre administrateur réseau de vous fournir cette partie du chemin d'accès de l'URL. Pour plus d'informations, consultez « Les paramètres du proxy ne sont pas correctement configurés sur cet ordinateur pour la découverte Web » dans le Kit de développement Visual Studio 2005 SDK.

Dans la zone Services Web disponibles de cette URL, sélectionnez le service Web à utiliser.

Vérifiez que votre projet peut utiliser le service Web et que tout code externe fourni est fiable.

Note de sécurité :
Lorsque vous ouvrez un projet en vue de le modifier et que celui-ci contient une référence Web, un fichier proxy local pour le service Web utilisé s'exécute dans un processus de Devenv.exe lancé par un utilisateur approuvé, vous-même. L'ouverture de projets ou de composants dans l'environnement de développement intégré est susceptible d'exécuter du code sur votre ordinateur local. Pour plus d'informations, consultez Vue d'ensemble des menaces de sécurité des applications Web et Sécurité d'accès du code.

Lorsque vous ouvrez un projet en vue de le modifier et que celui-ci contient une référence Web, un fichier proxy local pour le service Web utilisé s'exécute dans un processus de Devenv.exe lancé par un utilisateur approuvé, vous-même. L'ouverture de projets ou de composants dans l'environnement de développement intégré est susceptible d'exécuter du code sur votre ordinateur local. Pour plus d'informations, consultez Vue d'ensemble des menaces de sécurité des applications Web et Sécurité d'accès du code.

Dans le champ Nom de la référence Web, entrez un nom que vous utiliserez dans votre code pour accéder au service Web sélectionné par programme.

Remarque :
Par défaut, un espace de noms est assigné aux références Web, qui correspond à leur nom de serveur. Vous pouvez modifier cette valeur et entrer un nom d'espace de noms personnalisé. Il existe des restrictions aux noms d'espaces de noms autorisés. Pour plus d'informations sur les caractères qui ne sont pas autorisés dans un nom de référence Web, consultez Ajouter une référence Web, boîte de dialogue. Visual Web Developer crée un espace de noms basé sur le nom de la référence Web en générant une arborescence de dossiers imbriqués. Dans le dossier le plus profond, un fichier .wsdl qui fait référence au service Web est créé, avec des fichiers de prise en charge, tels que les fichiers de découverte (.disco et .discomap) qui incluent des informations sur l'emplacement du service Web.

Par défaut, un espace de noms est assigné aux références Web, qui correspond à leur nom de serveur. Vous pouvez modifier cette valeur et entrer un nom d'espace de noms personnalisé. Il existe des restrictions aux noms d'espaces de noms autorisés. Pour plus d'informations sur les caractères qui ne sont pas autorisés dans un nom de référence Web, consultez Ajouter une référence Web, boîte de dialogue. Visual Web Developer crée un espace de noms basé sur le nom de la référence Web en générant une arborescence de dossiers imbriqués. Dans le dossier le plus profond, un fichier .wsdl qui fait référence au service Web est créé, avec des fichiers de prise en charge, tels que les fichiers de découverte (.disco et .discomap) qui incluent des informations sur l'emplacement du service Web.

Cliquez sur Ajouter une référence.

Visual Studio crée un dossier App_WebReferences, si votre site Web n'en a pas déjà un. Il crée ensuite les fichiers requis pour la classe proxy à l'aide du nom fourni à l'étape 5.

Suppression d'une référence Web

Si une référence à un service Web XML est devenue inutile dans votre projet, vous pouvez la supprimer de ce dernier.

Pour supprimer une référence Web d'un projet

Dans l'Explorateur de solutions, cliquez avec le bouton droit sur la référence Web, puis cliquez sur Supprimer.

Toutes les informations concernant la référence sont supprimées du projet et du stockage local.

Voir aussi

Tâches

Comment : appeler un service Web

Procédure pas à pas : création et utilisation d'un service Web ASP.NET dans Visual Web Developer

Procédure pas à pas : création d'un service Web XML de base à l'aide d'ASP.NET

Concepts

Vue d'ensemble des services Web XML