Partager via


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

  1. 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.

  2. 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.

  3. Dans la liste Service, développez le nœud du service que vous souhaitez utiliser et sélectionnez un contrat de service.

  4. Dans la zone Espace de noms, entrez l'espace de noms que vous souhaitez utiliser pour la référence.

  5. 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

  1. 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.

  2. Cliquez sur Découvrir.

    Tous les services WCF figurant dans la solution actuelle sont ajoutés à la liste Service.

  3. Dans la liste Service, développez le nœud du service que vous souhaitez utiliser et sélectionnez un contrat de service.

  4. Dans la zone Espace de noms, entrez l'espace de noms que vous souhaitez utiliser pour la référence.

  5. Cliquez sur OK pour ajouter la référence au projet.

  6. 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

Autres ressources

Consuming ASMX and WCF Services Sample