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

Mise à jour : novembre 2007

La boîte de dialogue Ajouter une référence Web permet de rechercher des services Web et d'ajouter des références Web à un site Web. Une référence Web vous permet d'utiliser des objets et des méthodes fournis par un service Web dans votre code. Vous pouvez rechercher des services Web sur un ordinateur local ou sur les serveurs du réseau local de votre entreprise, ou encore chercher des services Web commerciaux sur Internet.

Pour ouvrir la boîte de dialogue Ajouter une référence Web

• Dans l'Explorateur de solutions, cliquez avec le bouton droit sur le nom du site Web, puis cliquez sur Ajouter une référence Web.

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

Après avoir ajouté une référence Web au projet en cours, vous pouvez utiliser dans votre application tout élément ou fonctionnalité fourni par ce service Web. Pour plus d'informations, consultez Vue d'ensemble des services Web XML.

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 s'exécute dans une instance du processus de Devenv.exe qui a été lancée par un utilisateur approuvé, vous-même. L'ouverture de projets ou de composants dans l'environnement de développement intégré (IDE) est susceptible d'autoriser l'exécution du code sur l'ordinateur local. Pour plus d'informations, consultez Sécurité d'accès du code.

Éléments d'interface

• Précédente
  

  Revient à la page précédemment affichée.

• Suivante
  

  Revient à la page affichée lorsque vous avez précédemment cliqué sur le bouton Précédente.

• Arrêter
  

  Interrompt le chargement de la page Web.

• Actualiser
  

  Actualise le contenu de la page active dans le volet gauche du navigateur.

• Accueil
  

  Affiche la page Commencer l'exploration pour les services Web dans le volet gauche du navigateur.

• Aller à
  

  Lance une recherche de services Web à l'adresse saisie dans le champ URL.

• URL
  Affiche l'URL d'un service Web que vous souhaitez que votre application utilise. Utilisez la liste déroulante pour sélectionner un service précédemment utilisé ou entrez un nouveau chemin d'accès commençant par http:// ou ftp://. Une URL de référence Web complète comprend un nom de domaine, un nom de service Web et le nom de son fichier de découverte .asmx, .wsdl, .disco ou .xsd. Par exemple, vous pouvez saisir ce qui suit :

  http://NomDomaine/NomServiceWeb/discoveryfile.asmx

  Le volet Commencer l'exploration pour les services Web cherche des services Web sur ce chemin d'accès et affiche la description des services éventuellement trouvés.

  Remarque :

  Le .NET Framework ne détecte pas automatiquement les serveurs proxy. 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. En outre, vous pouvez définir l'élément <defaultProxy>, élément (paramètres réseau) du fichier Machine.config ou Web.config. Tout HttpWebRequest qui n'inclut pas de propriété Proxy avec une valeur spécifique utilise le proxy par défaut. Pour plus d'informations, consultez Configuring Internet Applications.

• Commencer l'exploration pour les services Web
  Fournit des liens vers des listes de services Web disponibles. Après avoir cliqué sur l'un des liens, vous pouvez sélectionner le nom d'un service Web disponible répertorié et récupérer la description des méthodes qu'il prend en charge depuis le fichier WSDL (Web Services Description Language) de ce service. Pour plus d'informations, consultez Recherche de services Web et Génération de fichiers WSDL pour les services Web ASP.NET.

  Ce volet comporte les liens suivants :

  • Services Web dans cette solution   Répertorie les services Web disponibles dans la solution actuelle.

  • Services Web sur l'ordinateur local   Répertorie les services Web et les documents de découverte disponibles sur l'ordinateur local.

    Pour que ce lien renvoie des informations, un serveur Web, comme Services Internet (IIS), doit s'exécuter sur l'ordinateur local. Pour plus d'informations sur IIS, consultez la IIS Technical Library

  • Recherchez des serveurs UDDI sur le réseau local   Répertorie les serveurs de votre réseau local qui fournissent des services Web et des documents de découverte à l'aide des protocoles UDDI (Universal Description, Discovery, and Integration).

    Les protocoles UDDI standard permettent la découverte rapide et par programme des services Web disponibles d'une entreprise. Pour plus d'informations, consultez le site Web Microsoft UDDI.

• Services Web disponibles de cette URL
  Ce volet répertorie le nom de tous les services Web trouvés à l'URL spécifiée. Lorsque vous créez une référence Web, celle-ci fait référence à cette liste entière. Pour isoler un service Web précis, placez le pointeur sur l'élément souhaité dans cette liste. Une info-bulle affichera l'URL du service souhaité. Entrez l'URL de ce service et choisissez Aller à. Cette liste doit alors afficher uniquement le service Web choisi. Vous pouvez ensuite ajouter une référence à ce seul service.

• Nom de la référence Web
  Spécifie un nom unique que vous utiliserez dans votre code pour accéder par programme au service Web sélectionné. Si le nom entré correspond à un service Web existant, un numéro est ajouté afin de rendre unique cette nouvelle référence.

  Par défaut, un espace de noms est assigné aux références Web, qui correspond à leur nom de serveur. Visual Web Developer crée une référence Web en fonction du Nom de la référence Web que vous entrez dans le dossier App_WebReferences. Dans le dossier App_WebReferences, un fichier .wsdl faisant référence au service Web est créé, avec des fichiers de prise en charge, tels les fichiers de découverte (.disco et .discomap), qui incluent des informations sur l'emplacement du service Web.

  Les noms de la référence Web ne peuvent pas :

  • Contenir l'un des caractères suivants : / ? : \ * " < > ou |

  • Contenir des caractères de contrôle Unicode.

  • Être des noms réservés, y compris "CON", "AUX", "PRN", "COM1" et "LPT2".

• Ajouter la référence
  Crée une nouvelle référence Web dans votre application. Ce bouton est activé lorsqu'un ou plusieurs services Web disponibles à l'adresse saisie dans le champ URL sont répertoriés dans le champ Services Web disponibles de cette URL. Une nouvelle référence Web portant le nom indiqué dans le champ Nom de la référence Web apparaîtra dans l'Explorateur de solutions sous le nœud Références Web du projet en cours. Cette nouvelle référence Web rend disponibles pour votre application tous les services Web répertoriés.

  Remarque :
  Pour régénérer la classe proxy d'un service Web à l'aide de la copie la plus récente de son fichier de description .wsdl, cliquez avec le bouton droit sur la référence Web dans l'Explorateur de solutions et cliquez sur Mettre à jour la référence Web.

Voir aussi

Tâches

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

Concepts

Hébergement d'objets distants dans les Services Internet (IIS)

Exemple d'accès distant : hébergement dans les Services Internet (IIS)

Configuring Internet Applications

Référence

Les paramètres du proxy ne sont pas correctement configurés sur cet ordinateur pour la découverte Web.

Autres ressources

Accès aux services Web en code managé

Projets, éléments de l'interface utilisateur

Kit de développement IIS SDK

Documentation IIS 5.0

World Wide Web Consortium

Spécification WSDL

UDDI.org

Site Web Microsoft UDDI