Notes
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Au fil des ans, de nombreux développeurs Visual Studio ont apprécié la productivité que l'outil Add Service Reference offrait lorsque leurs projets .NET Framework avaient besoin d'accéder aux services web.
L’outil de référence du service web WCF est une extension de service connectée 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é Add Service Reference , qui concerne uniquement les projets .NET Framework. L’outil de référence du service web WCF récupère les métadonnées d’un service web dans la solution actuelle, sur un emplacement réseau ou à partir d’un fichier WSDL, et génère un fichier source contenant le code proxy client Windows Communication Foundation (WCF) que votre application .NET peut utiliser pour accéder au service web.
Importante
Vous ne devez référencer les services qu’à partir d’une source approuvée. L’ajout de références à partir d’une source non approuvée peut compromettre la sécurité.
Conditions préalables
- 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
Remarque
L’outil de référence du service web WCF s’applique uniquement aux projets C# .NET Core et .NET Standard, y compris les applications web ASP.NET Core.
À l’aide du modèle de projet d’application web principale ASP.NET comme exemple, cet article vous guide tout au long de l’ajout d’une référence de service WCF au projet.
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 indiqué dans l’image suivante :
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.
Sélectionnez Service web WCF, puis choisissez Suivant.
Cela fait apparaître l’Assistant Ajouter une nouvelle référence de service Web WCF.
Sélectionnez un service.
a) Plusieurs options de recherche de services sont disponibles :
- Pour rechercher les services définis dans la solution actuelle, cliquez sur le bouton Découvrir .
- Pour rechercher les services hébergés à une adresse spécifiée, entrez une URL de service dans la zone Adresse , puis cliquez sur le bouton Atteindre .
- Pour sélectionner un fichier WSDL qui contient les informations de métadonnées du 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.
v. Cliquez sur le bouton Suivant pour spécifier les options de type de données ou les options du client. Vous pouvez également cliquer sur le bouton Terminer pour utiliser les options par défaut.
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
L’option de case à cocher Réutiliser les types dans les assemblys référencés est utile lorsque les types de données nécessaires à la génération de 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 types au moment de la compilation ou les problèmes d’exécution.
Il peut y avoir un délai pendant le chargement des informations de type, en fonction du nombre de dépendances de projet et d’autres facteurs de performances système. Le bouton Terminer est désactivé pendant le chargement, sauf si la case à cocher Réutiliser les types dans les assemblys référencés n’est pas cochée.
Cliquez sur Terminer lorsque 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 du 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 requises pour compiler et s’exécuter 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 le produit, signalez-le à la Communauté des développeurs à l’aide de l’outil Signaler un problème .
Notes de publication
- Reportez-vous aux notes de publication pour obtenir des informations de publication mises à jour, notamment sur les problèmes connus.
Collaborer avec nous sur GitHub
La source de ce contenu se trouve sur GitHub, où vous pouvez également créer et examiner les problèmes et les demandes de tirage. Pour plus d’informations, consultez notre guide du contributeur.
