Comment : ajouter, mettre à jour ou supprimer une référence de service de données WCFHow to: Add, update, or remove a WCF data service reference

Un référence de service permet à un projet à l’accès à un ou plusieurs Services de données WCFWCF Data Services.A service reference enables a project to access one or more Services de données WCFWCF Data Services. Utilisez le ajouter une référence de Service boîte de dialogue pour rechercher des Services de données WCFWCF Data Services dans la solution actuelle, localement, sur un réseau local ou sur Internet.Use the Add Service Reference dialog box to search for Services de données WCFWCF Data Services in the current solution, locally, on a local area network, or on the Internet.

Note

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.Your computer might show different names or locations for some of the Visual Studio user interface elements in the following instructions. L’édition de Visual Studio dont vous disposez et les paramètres que vous utilisez déterminent ces éléments.The Visual Studio edition that you have and the settings that you use, determine these elements. Pour plus d’informations, consultez Personnaliser l’IDE.For more information, see Personalize the IDE.

Ajouter une référence de serviceAdd a service reference

Pour ajouter une référence à un service externeTo add a reference to an external service

  1. Dans l’Explorateur de solutions, cliquez sur le nom du projet auquel vous souhaitez ajouter le service, puis cliquez sur ajouter une référence de Service.In Solution Explorer, right-click the name of the project to which you want to add the service, and then click Add Service Reference.

    Le ajouter une référence de Service boîte de dialogue s’affiche.The Add Service Reference dialog box appears.

  2. Dans le adresse zone, entrez l’URL du service, puis cliquez sur accédez pour rechercher le service.In the Address box, enter the URL for the service, and then click Go to search for the service. Si le service implémente la sécurité de nom et mot de passe utilisateur, vous devrez peut-être utiliser un nom d’utilisateur et mot de passe.If the service implements user name and password security, you may be prompted for a user name and password.

    Note

    Vous devez référencer des services uniquement à partir d’une source approuvée.You should only reference services from a trusted source. L’ajout de références à partir d’une source non fiable peut compromettre la sécurité.Adding references from an untrusted source may compromise security.

    Vous pouvez également sélectionner l’URL à partir de la adresse liste, qui stocke les 15 URL précédentes à partir duquel les métadonnées de service valide a été trouvée.You can also select the URL from the Address list, which stores the previous 15 URLs at which valid service metadata was found.

    Une barre de progression affiche lors de la recherche est en cours d’exécution.A progress bar displays when the search is being performed. Vous pouvez arrêter la recherche à tout moment en cliquant sur arrêter.You can stop the search at any time by clicking Stop.

  3. Dans le Services liste, développez le nœud pour le service que vous souhaitez utiliser, puis sélectionnez un jeu d’entités.In the Services list, expand the node for the service that you want to use and select an entity set.

  4. Dans le Namespace , entrez l’espace de noms que vous souhaitez utiliser pour la référence.In the Namespace box, enter the namespace that you want to use for the reference.

  5. Cliquez sur OK pour ajouter la référence au projet.Click OK to add the reference to the project.

    Un client de service (proxy) est généré et les métadonnées qui décrivent le service sont ajoutée à la app.config fichier.A service client (proxy) is generated, and metadata that describes the service is added to the app.config file.

Pour ajouter une référence à un service dans la solution actuelleTo add a reference to a service in the current solution

  1. Dans l’Explorateur de solutions, cliquez sur le nom du projet auquel vous souhaitez ajouter le service, puis cliquez sur ajouter une référence de Service.In Solution Explorer, right-click the name of the project to which you want to add the service, and then click Add Service Reference.

    Le ajouter une référence de Service boîte de dialogue s’affiche.The Add Service Reference dialog box appears.

  2. Cliquez sur découvrir.Click Discover.

    Tous les services (les deux Services de données WCFWCF Data Services et les services WCF) dans la solution actuelle sont ajoutés à la Services liste.All services (both Services de données WCFWCF Data Services and WCF services) in the current solution are added to the Services list.

  3. Dans le Services liste, développez le nœud pour le service que vous souhaitez utiliser, puis sélectionnez un jeu d’entités.In the Services list, expand the node for the service that you want to use and select an entity set.

  4. Dans le Namespace , entrez l’espace de noms que vous souhaitez utiliser pour la référence.In the Namespace box, enter the namespace that you want to use for the reference.

  5. Cliquez sur OK pour ajouter la référence au projet.Click OK to add the reference to the project.

    Génère un client de service (proxy), et les métadonnées qui décrivent le service sont ajoutée à la app.config fichier.A service client (proxy) generates, and metadata that describes the service is added to the app.config file.

Mise à jour une référence de serviceUpdate a service reference

L’Entity Data Model pour un Services de données WCFWCF Data Services parfois change.The Entity Data Model for a Services de données WCFWCF Data Services sometimes changes. Dans ce cas, vous devez mettre à jour la référence de service.When this happens, you must update the service reference.

Pour mettre à jour une référence de serviceTo update a service reference

  • Dans l’Explorateur de solutions, avec le bouton droit de la référence de service, puis cliquez sur référence de Service de mise à jour.In Solution Explorer, right-click the service reference and then click Update Service Reference.

    Une boîte de dialogue de progression affiche alors que la référence est mis à jour à partir de son emplacement d’origine et le client du service est régénéré pour refléter ces modifications dans les métadonnées.A progress dialog box displays while the reference is updated from its original location, and the service client is regenerated to reflect any changes in the metadata.

Supprimer une référence de serviceRemove a service reference

Si une référence de service est n’est plus utilisée, vous pouvez le supprimer à partir de votre solution.If a service reference is no longer being used, you can remove it from your solution.

Pour supprimer une référence de serviceTo remove a service reference

  • Dans l’Explorateur de solutions, avec le bouton droit de la référence de service, puis cliquez sur supprimer.In Solution Explorer, right-click the service reference and then click Delete.

    Le client du service sera retiré de la solution et les métadonnées qui décrivent le service seront retirée le app.config fichier.The service client will be removed from the solution, and the metadata that describes the service will be removed from the app.config file.

    Note

    Tout code qui fait référence à la référence de service doit être supprimé manuellement.Any code that references the service reference must be removed manually.

Voir aussiSee also