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.

Prérequis

• Visual Studio 2017 version 15.5 ou une version ultérieure

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

Comment utiliser l’extension

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 :

   

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.

   

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 :

   

   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.

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

• Prise en main des applications Windows Communication Foundation
• Services Windows Communication Foundation et services de données WCF dans Visual Studio
• Fonctionnalités prises en charge par WCF sur .NET Core

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.