Comment : ajouter une référence à un service Web

Services Web XML, également connu sous le nom de services ASMX, est le prédécesseur de Windows Communication Foundation (WCF).Vous pouvez accéder aux services Web en ajoutant une référence de service comme vous le feriez pour tout autre service WCF. Toutes les références ajoutées de cette manière ciblent la version la plus récente du .NET Framework.

Pour les applications qui ont été créées dans une version antérieure de Visual Studio, vous pouvez toujours ajouter une référence Web qui cible la version 2.0 du .NET Framework.Pour ce faire, suivez la procédure décrite dans la section suivante.

[!REMARQUE]

N'ajoutez une référence Web que si votre application cible la version 2.0 du .NET Framework.Pour ajouter une référence de service qui cible la version actuelle du .NET Framework, consultez Comment : ajouter, mettre à jour ou supprimer une référence de service.

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

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

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

2. Dans la boîte de dialogue Ajouter une référence de service, cliquez sur le bouton Avancé.

   La boîte de dialogue Paramètres de référence de service s'affiche.

3. Dans la boîte de dialogue Paramètres de référence de service, cliquez sur Ajouter une référence Web.

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

4. 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 va consommer des services Web situés en dehors de ce pare-feu, vous devez alors 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..

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

6. 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 consommé s'exécute dans un processus de Devenv.exe lancé par un utilisateur approuvé, à savoir vous-même.L'ouverture de projets ou de composants dans l'environnement de développement intégré (IDE, Integrated Development Environment) peut exécuter du code sur l'ordinateur local.Pour plus d'informations, consultez Code Access Security.

7. 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.Pour créer un espace de noms basé sur le nom de la référence Web, générez 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 comportent des informations sur l'emplacement du service Web.

8. Cliquez sur Ajouter une référence.

   Si votre site de projet ne possède pas de dossier WebReferences, Visual Studio en crée un.Il crée ensuite les fichiers qui sont requis pour la classe proxy à l'aide du nom que vous avez indiqué à l'étape 7.

Voir aussi

Tâches

Comment : ajouter, mettre à jour ou supprimer une référence de service

Référence

Ajouter une référence de service, boîte de dialogue

Concepts

Services Windows Communication Foundation et services de données WCF dans Visual Studio

Web References in Visual Studio

Autres ressources

Consuming ASMX and WCF Services Sample