Références Web dans Visual Studio
Mise à jour : novembre 2007
Pour simplifier le développement d'applications clientes du service Web XML, Visual Studio fournit les références Web. Les références Web diffèrent des références et des composants traditionnels ; au lieu de référencer une bibliothèque de classes ou un composant installé sur l'ordinateur local, une référence Web fournit l'accès à une ressource disponible à l'aide d'un protocole Internet tel que SOAP ou HTTP.
En pratique, une référence Web est une classe proxy générée qui représente localement la fonctionnalité exposée d'un service Web XML. La classe proxy définit des méthodes qui représentent les méthodes réelles exposées par un service Web XML. Lorsqu'une instance de la classe proxy est créée par votre application, cette dernière est capable d'appeler les méthodes du service Web XML comme si ce dernier était un composant localement disponible. Pour plus d'informations sur la création d'une référence Web, consultez Comment : ajouter et supprimer des références Web.
.gif "Remarque") Remarque : |
|---|
Pour rendre des services Web XML situés à l'extérieur d'un pare-feu disponibles dans le navigateur Web, vous devez spécifier explicitement l'adresse et le port du serveur proxy de votre réseau lorsque vous créez la référence Web dans Visual Studio. |
Le langage de programmation d'une classe proxy générée sera identique à celui du service Web que la classe proxy représente. Si vous créez la classe proxy indépendamment Visual Studio (par exemple, en utilisant un outil .NET Framework), le langage de programmation dépend de l'outil utilisé. Par exemple, si vous utilisez WSDL.exe, vous indiquez le langage de programmation, C# ou Visual Basic, sur la ligne de commande. Si vous utilisez SProxy.exe, le langage de programmation est Visual C++. Pour plus d'informations, consultez Outil Web Services Description Language Tool (Wsdl.exe).
Au moment du design, la classe proxy vous permet d'utiliser la saisie semi-automatique des instructions pour les méthodes du service Web XML. Au moment de l'exécution, un appel à une méthode de l'objet proxy est traité et codé comme un message de demande SOAP. Si le service Web XML ne prend pas en charge le protocole SOAP, la classe proxy utilise HTTP GET et POST. Le message est ensuite envoyé au service Web cible pour être traité. Si la description du service définit un message de réponse, l'objet proxy le traite et retourne une réponse à votre application.
Gestion des références Web
Vous pouvez renommer ou modifier les références Web ou les mettre à jour si le service Web référencé a changé. Pour plus d'informations, consultez Comment : renommer une référence Web de projet et Comment : mettre à jour une référence Web de projet.
Propriété URLBehavior
Chaque référence Web de votre projet interagit avec une classe proxy utilisée pour accéder au service Web. Vous pouvez utiliser la propriété URL de la référence Web pour indiquer l'URL du service Web XML. Dans ASP.NET 1.1, une référence Web peut utiliser une URL statique ou dynamique. Dans ASP.NET 2.0 et versions ultérieures, une référence Web obtient l'URL dynamiquement. Pour plus d'informations, consultez Recherche de services Web.
Lorsque vous créez une référence Web dans Visual Studio à l'aide de la boîte de dialogue Ajouter une référence Web, cette propriété a comme valeur par défaut l'URL du service Web XML sélectionné, qui est une URL statique. Si vous gardez la valeur statique par défaut pour le comportement de l'URL, la classe proxy définit la propriété de l'URL à l'aide d'une URL codée en dur lorsque vous créez une instance de la classe.
Si vous rendez dynamique le comportement de l'URL de la référence Web, l'application obtient l'URL de l'élément <appSettings> du fichier de configuration de votre application au moment de l'exécution.
Voir aussi
Tâches
Comment : ajouter et supprimer des références Web
Comment : renommer une référence Web de projet
Comment : mettre à jour une référence Web de projet
Procédure pas à pas : création et utilisation d'un service Web ASP.NET dans Visual Web Developer
Concepts
Création d'un proxy de service Web XML