ajouter, mettre à jour ou supprimer une référence de service de données WCF

  • Article

Pour les projets .NET Framework, une référence de service permet à un projet d’accéder à un ou plusieurs services WCF Data Services. Utilisez la boîte de dialogue Ajouter une référence de service pour rechercher WCF Data Services dans la solution actuelle, localement, sur un réseau local ou sur Internet.

Pour les projets .NET Core, vous pouvez utiliser le nœud Services connectés dans l’Explorateur de solutions pour accéder au Fournisseur Microsoft WCF Web Service Reference, qui vous permet de gérer les références de service de données WCF (Windows Communication Foundation).

Notes

Dans cet article, il est possible que votre ordinateur affiche des noms ou des emplacements différents pour certains éléments de l’interface utilisateur Visual Studio. Il se peut que vous utilisiez une autre édition de Visual Studio ou d’autres paramètres d’environnement. Pour plus d’informations, consultez Personnaliser l’IDE.

Prérequis

Les outils WCF ne sont pas installés avec la charge de travail .NET. Utilisez Visual Studio Installer pour modifier votre installation. Dans le programme d’installation, choisissez Windows Communication Foundation sous Composants individuels. Consultez Modifier Visual Studio.

Ajouter une référence de service WCF

Pour ajouter une référence à un service externe (projets .NET Framework)

  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 Atteindre pour rechercher le service. Si le service implémente une sécurité avec nom d'utilisateur et mot de passe, un nom d'utilisateur et un mot de passe peuvent vous être demandés. Vous pouvez également choisir un service dans votre propre solution. Cliquez sur le bouton Découvrir, puis choisissez Services dans la solution.

    Notes

    Vous devez référencer des services uniquement à partir d’une source approuvée. L'ajout de références à partir d'une source non fiable peut compromettre la sécurité.

    Vous pouvez également sélectionner l’URL dans la liste Adresse, qui stocke les 15 dernières URL auxquelles des métadonnées de service valides ont été trouvées.

    Une barre de progression s’affiche pendant la recherche. Vous pouvez arrêter la recherche à tout moment en cliquant sur Arrêter.

  3. Dans la liste Services, développez le nœud du service que vous souhaitez utiliser, puis sélectionnez un jeu d’entités.

  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 des métadonnées décrivant le service sont ajoutées au fichier app.config.

Pour ajouter une référence à un service externe (projets .NET Core, y compris .NET 5 et versions ultérieures)

  1. Dans l’Explorateur de solutions, double-cliquez ou appuyez sur le nœud Services connectés.

    L’onglet Configurer les services s’ouvre.

  2. Choisissez Fournisseur Microsoft WCF Web Service Reference.

    La boîte de dialogue Configurer une référence de service WCF Web Service s’affiche.

    Capture d’écran de la boîte de dialogue relative au fournisseur WCF Web Service

  3. Dans la zone URI, entrez l’URL du service, puis cliquez sur Atteindre pour rechercher le service. Si le service implémente une sécurité avec nom d'utilisateur et mot de passe, un nom d'utilisateur et un mot de passe peuvent vous être demandés.

    Remarque

    Vous devez référencer des services uniquement à partir d’une source approuvée. L'ajout de références à partir d'une source non fiable peut compromettre la sécurité.

    Vous pouvez également sélectionner l’URL dans la liste URI, qui stocke les 15 dernières URL auxquelles des métadonnées de service valides ont été trouvées.

    Une barre de progression s’affiche pendant la recherche. Vous pouvez arrêter la recherche à tout moment en cliquant sur Arrêter.

  4. Dans la liste Services, développez le nœud du service que vous souhaitez utiliser, puis sélectionnez un jeu d’entités.

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

  6. Cliquez sur Terminer pour ajouter la référence au projet.

    Un client de service (proxy) est généré et des métadonnées décrivant le service sont ajoutées au fichier app.config.

Pour ajouter une référence à un service dans la solution actuelle (projets .NET Framework)

  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 Data Services et services WCF) de la solution actuelle sont ajoutés à la liste Services.

  3. Dans la liste Services, développez le nœud du service que vous souhaitez utiliser, puis sélectionnez un jeu d’entités.

  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 des métadonnées décrivant le service sont ajoutées au fichier app.config.

Pour ajouter une référence à un service dans la solution actuelle (projets .NET Core)

  1. Dans l’Explorateur de solutions, double-cliquez ou appuyez sur le nœud Services connectés.

    L’onglet Configurer les services s’ouvre.

  2. Choisissez Fournisseur Microsoft WCF Web Service Reference.

    La boîte de dialogue Configurer une référence de service WCF Web Service s’affiche.

  3. Cliquez sur Découvrir.

    Tous les services (WCF Data Services et services WCF) de la solution actuelle sont ajoutés à la liste Services.

  4. Dans la liste Services, développez le nœud du service que vous souhaitez utiliser, puis sélectionnez un jeu d’entités.

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

  6. Cliquez sur Terminer pour ajouter la référence au projet.

    Un client de service (proxy) est généré et des métadonnées décrivant le service sont ajoutées au fichier app.config.

Ajouter une référence de service

Le modèle Entity Data Model d’un service WCF Data Services peut être amené à changer. Dans ce cas, vous devez mettre à jour 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 regénéré pour refléter les modifications éventuelles dans les métadonnées.

Pour les projets .NET Core, utilisez l’outil dotnet-svcutil. Consultez dotnet-svcutil pour l’installation et les instructions.

Pour les projets .NET Framework :

  • Dans l’Explorateur de solutions, développez le nœud Services connectés, 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 regénéré pour refléter les modifications éventuelles dans les métadonnées.

Supprimer 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 sera supprimé de la solution et les métadonnées qui décrivent le service seront supprimées du fichier app.config.

    Notes

    Tout code qui référence la référence de service doit être supprimé manuellement.

Contenu connexe