Comment : ajouter, mettre à jour ou supprimer une référence de service
Une référence de service permet à un projet d'accéder à un ou plusieurs services Windows Communication Foundation (WCF). Utilisez la boîte de dialogue Ajouter une référence de service pour rechercher des services WCF dans la solution actuelle, localement, sur un réseau local ou sur Internet.
Ajout d'une référence de service
Pour ajouter une référence à un service externe
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.
Dans la zone Adresse, entrez l'URL du service, puis cliquez sur Aller à pour rechercher le service. Si le service implémente la sécurité nom d'utilisateur/mot de passe, vous serez peut-être invité à entrer un nom d'utilisateur et un mot de passe.
Notes
Vous devez uniquement référencer des services provenant d'une source fiable. Si vous ajoutez des références provenant d'une source non fiable, cela risque de compromettre la sécurité.
Notes
Vous pouvez également sélectionner l'URL dans une liste déroulante qui stocke les 15 dernières URL dans lesquelles des métadonnées de service valides ont été trouvées.
Une barre de progression s'affiche pendant la recherche. Vous pouvez arrêter à tout moment la recherche en cliquant sur Arrêter.
Dans la liste Service, développez le nœud du service que vous souhaitez utiliser et sélectionnez un contrat de service.
Dans la zone Espace de noms, entrez l'espace de noms que vous souhaitez utiliser pour la référence.
Cliquez sur OK pour ajouter la référence au projet.
Un client de service (proxy) est généré et les métadonnées qui décrivent le service sont ajoutées au fichier app.config.
Pour ajouter une référence à un service dans la solution actuelle
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.
Cliquez sur Découvrir.
Tous les services WCF figurant dans la solution actuelle sont ajoutés à la liste Service.
Dans la liste Service, développez le nœud du service que vous souhaitez utiliser et sélectionnez un contrat de service.
Dans la zone Espace de noms, entrez l'espace de noms que vous souhaitez utiliser pour la référence.
Cliquez sur OK pour ajouter la référence au projet.
Un client de service (proxy) est généré et les métadonnées qui décrivent le service sont ajoutées au fichier app.config.
Mise à jour d'une référence de service
Avec le temps, les métadonnées d'un service WCF peuvent changer et requérir la mise à jour de la référence de service.
Pour mettre à jour une référence de service
Dans l'Explorateur de solutions, cliquez avec le bouton droit sur la référence de service, puis cliquez sur Mettre à jour la référence de service.
Une boîte de dialogue de progression s'affiche pendant la mise à jour de la référence à partir de son emplacement d'origine et le client de service est régénéré pour répercuter toutes les modifications dans les métadonnées.
Suppression d'une référence de service
Si une référence de service n'est plus utilisée, vous pouvez la supprimer de votre solution.
Pour supprimer une référence de service
Dans l'Explorateur de solutions, cliquez avec le bouton droit sur la référence de service, puis cliquez sur Supprimer.
Le client de service est supprimé de la solution et les métadonnées qui décrivent le service sont supprimés du fichier app.config.
Notes
Tout code qui référence la référence de service doit être supprimé manuellement.
Voir aussi
Tâches
Comment : ajouter une référence à un service Web
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