Modèles Visual Studio WCF

Article
04/03/2023

Les modèles Windows Communication Foundation (WCF) Visual Studio sont des modèles de projet et d’éléments prédéfinis que vous pouvez utiliser dans Visual Studio pour créer rapidement des services WCF et des applications environnantes.

Utilisation des modèles WCF

Les modèles WCF Visual Studio fournissent une structure de classe de base pour le développement de services. Spécifiquement, ces modèles fournissent les définitions de base pour les contrats de service, les contrats de données, les implémentations de services et les configurations. Vous pouvez utiliser ces modèles pour créer un service simple avec une interaction minimale du code, ainsi qu'un bloc de création pour des services plus avancés.

Modèle de projet Bibliothèque du service WCF

Le modèle de projet Bibliothèque du service WCF est disponible dans la boîte de dialogue de nouveau projet, dans Visual C#\WCF et dans Visual Basic\WCF.

Lorsque vous créez un projet à l’aide du modèle Service WCF, le nouveau projet inclut automatiquement les trois fichiers suivants :

Fichier de contrat de service (IService1.cs ou IService1.vb). Le fichier de contrat de service est une interface qui possède des attributs de service WCF. Ce fichier contient la définition d'un service simple destinée à vous aider à définir vos services et inclut des opérations basées des paramètres, ainsi qu'un exemple de contrat de données simple. Il s’agit du fichier par défaut qui s’affiche dans l’éditeur de code après la création d’un projet de service WCF.
Fichier d'implémentation de service (Service1.cs ou Service1.vb). Le fichier d'implémentation de service implémente le contrat défini dans le fichier de contrat de service.
Fichier de configuration de l'application (App.config). Le fichier de configuration fournit les éléments de base d’un modèle de service WCF avec une liaison HTTP sécurisée. Il inclut également un point de terminaison applicable au service et active l'échange de métadonnées.

Notes

Visual Studio est configuré pour reconnaître le fichier App.config comme fichier de configuration du projet lorsqu’il est exécuté à l’aide de WCF Service Host (WcfSvcHost.exe), ce qui représente la configuration par défaut. Si la bibliothèque de services se trouve dans un fichier exécutable, vous devez déplacer le code de configuration vers le fichier de configuration du fichier exécutable : en effet, les fichiers de configuration des DLL ne sont pas valides.

Modèle d'application de service WCF

Le modèle d’application de service WCF est disponible dans la boîte de dialogue Nouveau projet, dans Visual C#\WCF et dans Visual Basic\WCF.

Lorsque vous créez un projet à l’aide du modèle Service d’application Web WCF, le projet comprend les quatre fichiers suivants :

Fichier d'hôte de service (service1.svc).
Fichier de contrat de service (IService1.cs ou IService1.vb).
Fichier d'implémentation de service (Service1.svc.cs ou Service1.svc.vb).
Fichier de configuration Web (Web.config).

Le modèle crée automatiquement un site Web (à déployer dans un répertoire virtuel) et y héberge un service.

Modèle de site Web WCF

Le modèle de site web WCF est disponible dans la boîte de dialogue Nouveau projet sous Visual C#\Web Site\WCF Service et Visual Basic\Web Site\WCF Service. Cela crée les mêmes fichiers que ceux du modèle d’application de service WCF, mais les classe comme s’il s’agissait d’un site web ASP.NET. Les dossiers App_Code et App_Data sont créés.

Modèle d'élément de service WCF

Le modèle d’élément de service WCF est un modèle personnalisé qui permet d’ajouter rapidement des services WCF à vos projets Visual Studio existants.

Pour utiliser ce modèle, accédez au volet Explorateur de solutions, puis cliquez avec le bouton droit sur le nom de projet souhaité ; ensuite, pointez sur Ajouter, puis cliquez sur Nouvel élément pour ouvrir la boîte de dialogue Ajouter un nouvel élément.

L'interface de service et les fichiers d'implémentation sont placés dans le dossier du projet racine.

Le modèle tente de fusionner la section de configuration du nouveau service avec le fichier de configuration existant, si leurs types sont compatibles.

Un fichier d'hôte de service (service1.svc) est également créé si le projet existant est un projet Web.

Modèles d'élément et de projet de service WF WCF.

Ces modèles créent des services WCF qui hébergent un service de workflow, dont l’accès est identique à celui d’un service Web. Différents modèles existent pour les XAML et les modèles de programmation impératifs. À l'aide des modèles, vous pouvez créer des workflows séquentiels ou des workflows de l'ordinateur d'état. Pour plus d’informations sur ces types de workflow, consultez Guide pratique pour créer un workflow. Pour plus d’informations sur la création de projets de workflow, consultez Création de projets de workflows hérités.

Le concepteur Visual Studio est plus réactif lorsque des workflows de type XOML sont utilisés au lieu de workflows basés sur le code. Le workflow XOML est le type de workflow par défaut à créer.

Modèle de la bibliothèque du service de syndication WCF

Ce modèle permet d’exposer votre flux au format RSS ou ATOM en tant que service WCF. Pour plus d’informations, consultez Syndication WCF.

Modification de l'adresse du flux

Le modèle de syndication utilise un navigateur web lors de l’exécution. Quand vous cliquez avec le bouton droit sur votre projet dans l’Explorateur de solutions dans Visual Studio, sélectionnez Propriétés, puis cliquez sur l’onglet Débogage : vous pouvez alors voir l’adresse par défaut du modèle. Le navigateur tente d’ouvrir le flux à cette adresse.

Si vous modifiez l’adresse de votre flux, vous devez également changer l’adresse sous l’onglet Débogage. Si vous ne le faites pas, le navigateur tente d’ouvrir le flux à l’adresse par défaut et échoue.

Modèle d'élément de service WCF AJAX

Ce modèle expose un contrôle AJAX en tant que service WCF. Pour plus d’informations sur les contrôles AJAX, consultez la documentation relative aux contrôles AJAX (page pouvant être en anglais).

Modèle d'élément de service WCF compatible Silverlight

Ce modèle crée un service Web qui fournit des données à un client Silverlight ou frontal. Il peut être ajouté à un site web ou à un projet d’application Web pour créer un service WCF, qui inclut le code et la configuration du service prenant en charge la communication avec un client Silverlight. Vous pouvez ensuite utiliser l’option Ajouter une référence de service pour ajouter un proxy client du service au client et échanger des données entre le client Silverlight et le service WCF compatible Silverlight.

Pour accéder à ce modèle, cliquez avec le bouton droit sur un site web ou un projet d’application Web dans l’Explorateur de solutions, cliquez sur Ajouter un nouvel élément, puis cliquez sur Service WCF compatible Silverlight.