Comment : générer un proxy de service Web

Mise à jour : novembre 2007

Pour accéder à un service Web à partir d'une application cliente, vous ajoutez d'abord une référence Web, qui est une référence à un service Web. Quand vous créez une référence Web, Visual Studio crée automatiquement une classe proxy de service Web et l'ajoute à votre projet. Cette classe proxy expose les méthodes du service Web et gère le marshaling des arguments appropriés entre le service Web et votre application. Visual Studio utilise le langage WSDL pour créer le proxy. Pour plus d'informations, consultez Infrastructure des services Web XML.

Vous pouvez utiliser la propriété de l'URL de la référence Web pour indiquer l'URL du service Web. L'option Ajouter une référence Web définit cette propriété par défaut à l'URL du service Web sélectionnée, qui est une URL statique. Une référence Web peut utiliser une URL statique ou dynamique. Si vous affectez la valeur dynamic à la propriété du comportement de l'URL de la référence Web, l'application obtient l'URL au moment de l'exécution de l'élément appSettings, élément (Schéma des paramètres généraux) du fichier de configuration de l'application. Pour plus d'informations, consultez Références Web dans Visual Studio.

Après avoir ajouté une référence Web à une application cliente, vous pouvez appeler les méthodes exposées de ce service Web et accéder aux résultats comme vous le feriez pour toute autre méthode d'un composant. Pour plus d'informations, consultez Comment : appeler un service Web.

Si vous ne pouvez pas ajouter une référence Web (lorsque le service Web n'est pas accessible à partir de l'ordinateur sur lequel vous utilisez Visual Studio, par exemple), vous pouvez utiliser l'outil Wsdl.exe (Web Services Description Language) pour générer une classe proxy du client du service Web. Pour plus d'informations, consultez Création d'un proxy de service Web XML.

Pour générer une classe proxy de service Web

  • Ajoutez une référence Web à votre projet. Pour plus d'informations, consultez Comment : ajouter et supprimer des références Web. Une classe proxy est générée automatiquement et ajoutée à votre solution ; elle peut ensuite être instanciée comme toute autre classe.

Voir aussi

Tâches

Comment : appeler un service Web

Concepts

Références Web dans Visual Studio

Création d'un proxy de service Web XML

Référence

Outil Web Services Description Language Tool (Wsdl.exe)

Autres ressources

Accès aux services Web en code managé