Leçon 2 : ajout d'une référence Web

La découverte de service Web est le processus suivant lequel un client recherche un service Web et obtient sa description. Dans Visual Studio, le processus de la découverte de service Web implique l'interrogation d'un site Web suivant un algorithme prédéterminé. L'objectif de ce processus est de rechercher la description du service, qui correspond à un document XML utilisant le langage WSDL (Web Services Description Language).

La description du service décrit les services disponibles et la manière d'interagir avec ces derniers. Sans une description de service, il est impossible d'interagir par programme avec un service Web.

Votre application doit pouvoir communiquer avec le service Web et le rechercher lors de l'exécution. L'ajout d'une référence Web à votre projet pour le service Web permet cela en générant une classe proxy qui joue le rôle d'interface avec le service Web et qui en fournit une représentation locale. Pour plus d'informations, consultez « Procédure : générer un XML d'un proxy de service Web » dans la documentation Visual Studio.

Pour ajouter une référence Web

  1. Dans le menu Projet, cliquez sur Ajouter une référence de service.

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

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

  4. Dans la zone URL de la boîte de dialogue Ajouter une référence Web, tapez l'URL permettant d'obtenir la description du service Web Report Server, par exemple : https://localhost/reportserver/reportservice2005.asmx. Cliquez ensuite sur le bouton OK pour extraire les informations relatives au service Web.

    - ou -

    Si le service Web Report Server se trouve sur l'ordinateur local, cliquez sur le lien Services Web sur l'ordinateur local dans le volet du navigateur. Cliquez ensuite sur le lien du service Web ReportService2005 dans la liste fournie.

  5. Dans la zone Nom de la référence Web, attribuez à la référence Web le nom ReportService2005, qui correspond à l'espace de noms que vous utiliserez pour cette référence Web.

  6. Cliquez sur Ajouter une référence pour ajouter une référence Web au service Web cible.

    Visual Studio télécharge la description du service et génère une classe proxy pour jouer le rôle d'interface entre votre application et le service Web Report Server. Vous devrez également ajouter une référence à l'espace de noms System.Web.Services pour que votre référence Web fonctionne.

  7. Dans le menu Projet, cliquez sur Ajouter une référence.

  8. Dans la boîte de dialogue Ajouter une référence, dans l'onglet .NET, sélectionnez System.Web.Services, puis cliquez sur OK.

Pour plus d'informations, consultez Accès à l'API SOAP.