Utiliser l’outil WCF Web Service Reference Provider

Au fil des années, de nombreux développeurs Visual Studio ont apprécié le gain de productivité offert par l’outil Ajouter une référence de service quand leurs projets .NET Framework avaient besoin d’accéder à des services web.

L’outil Référence au service Web WCF est une extension de service connecté Visual Studio qui vous permet de connecter votre projet .NET 5+, .NET Core ou ASP.NET Core à un service web. Il offre une expérience similaire à la fonctionnalité Ajouter une référence de service, qui est destinée uniquement aux projets .NET Framework. L’outil Référence au service Web WCF récupère les métadonnées d’un service web dans la solution actuelle sur un emplacement réseau ou dans un fichier WSDL, puis génère un fichier source contenant du code de proxy client WCF (Windows Communication Foundation) que votre application .NET peut utiliser pour accéder au service web.

Important

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

Prérequis

Les captures d’écran de cet article proviennent de Visual Studio 2022.

Comment utiliser l’extension

Notes

L’outil Référence au service Web WCF s’applique uniquement aux projets C# .NET Core et .NET Standard, y compris les applications web ASP.NET Core.

Prenant le modèle de projet Application web ASP.NET Core en guise d’exemple, cet article explique comment ajouter une référence de service WCF au projet.

  1. Dans l’Explorateur de solutions, double-cliquez sur le nœud Services connectés du projet. (Pour un projet .NET Core ou .NET Standard, cliquez avec le bouton droit sur le projet, puis sélectionnez Ajouter>Service connecté.)

    La page Services connectés s’affiche, comme illustré ci-dessous :

    Visual Studio Connected Services tab for .NET Core

  2. Dans la page Services connectés, sélectionnez Ajouter une référence de service.

    La page Ajouter une référence de service s’ouvre.

  3. Sélectionnez Service web WCF, puis choisissez Suivant.

    Cela fait apparaître l’Assistant Ajouter une nouvelle référence de service Web WCF.

    Visual Studio Service Endpoint tab for .NET Core

  4. Sélectionnez un service.

    a. Plusieurs options de recherche de services sont disponibles :

    • Pour rechercher parmi les services définis dans la solution actuelle, cliquez sur le bouton Découvrir.
    • Pour rechercher parmi les services hébergés à une adresse spécifiée, entrez une URL de service dans la zone Adresse, puis cliquez sur le bouton Envoyer.
    • Pour sélectionner un fichier WSDL qui contient les informations de métadonnées de service web, cliquez sur le bouton Parcourir.

    b. Sélectionnez le service dans la liste des résultats de recherche dans la zone Services. Si nécessaire, entrez l’espace de noms du code généré dans la zone de texte Espace de noms correspondante.

    c. Cliquez sur le bouton Suivant pour spécifier les options de type de données ou les options client. Vous pouvez aussi cliquer sur le bouton Terminer pour utiliser les options par défaut.

  5. La page Options de type de données permet d’affiner les paramètres de configuration de référence de service générés :

    Visual Studio Data type options tab for .NET Core

    Remarque

    La case à cocher Réutiliser les types dans les assemblys référencés est utile quand les types de données nécessaires pour la génération du code de référence de service sont définis dans l’un des assemblys référencés de votre projet. Il est important de réutiliser ces types de données existants pour éviter les conflits de type au moment de la compilation ou les problèmes au moment de l’exécution.

    Il peut y avoir un délai pendant le chargement des informations de type, en fonction du nombre de dépendances du projet et d’autres facteurs de performances système. Le bouton Terminer est désactivé pendant le chargement, sauf si la case Réutiliser les types dans les assemblys référencés est cochée.

  6. Cliquez sur Terminer quand vous avez terminé.

Lors de l’affichage de la progression, l’outil :

  • Télécharge les métadonnées à partir du service WCF.
  • Génère le code de référence de service dans un fichier nommé reference.cs et l’ajoute à votre projet sous le nœud Services connectés.
  • Met à jour le fichier projet (.csproj) avec les références de package NuGet nécessaires pour la compilation et l’exécution sur la plateforme cible.

Visual Studio Progress window

Une fois ces processus terminés, vous pouvez créer une instance du type de client WCF généré et appeler les opérations de service.

Voir aussi

Commentaires et questions

Si vous avez des commentaires sur les produits, signalez-le à Developer Community à l’aide de l’outil Signaler un problème.

Notes de publication

  • Pour obtenir des informations à jour sur les versions, notamment les problèmes connus, consultez les Notes de publication.