How to: Add, Update, or Remove a WCF Data Service Reference
Date de publication : mars 2016
Une référence de service permet à un projet d'accéder à un ou plusieurs Services de données WCF. Utilisez la boîte de dialogue Ajouter une référence de service pour rechercher Services de données WCF dans la solution actuelle, localement, sur un réseau local ou sur Internet.
Notes
Il est possible que pour certains des éléments de l'interface utilisateur de Visual Studio, votre ordinateur affiche des noms ou des emplacements différents de ceux indiqués dans les instructions suivantes. L'édition de Visual Studio dont vous disposez et les paramètres que vous utilisez déterminent ces éléments. Pour plus d'informations, consultez Personnalisation de l'IDE.
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é du nom d'utilisateur et du 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é.
Vous pouvez sélectionner également l'URL dans la liste d'adresses, qui stocke les 15 URL précédentes pour 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 Services, développez le nœud du service que vous souhaitez utiliser et sélectionnez un jeu d'entités.
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 (à la fois les services Services de données WCF et les services WCF) dans la solution actuelle sont ajoutés à la liste des Services.
Dans la liste Services, développez le nœud du service que vous souhaitez utiliser et sélectionnez un jeu d'entités.
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
Le modèle EDM (Entity Data Model) d'un service Services de données WCF change parfois. Lorsque cela se produit, la référence de service doit être mise à jour.
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.