Modèles WCF Visual Studio

Les modèles Visual Studio Windows Communication Foundation (WCF) sont des modèles de projet et d’élément prédéfinis que vous pouvez utiliser dans Visual Studio pour générer 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. Plus précisément, ces modèles fournissent les définitions de base pour le contrat de service, le contrat de données, l’implémentation de service et la configuration. Vous pouvez utiliser ces modèles pour créer un service simple avec une interaction de code minimale, ainsi qu’un bloc de construction pour des services plus avancés.

Modèle de projet de bibliothèque de services WCF

Le modèle de projet bibliothèque de services WCF est disponible dans la boîte de dialogue nouveau projet sous Visual C#\WCF et Visual Basic\WCF.

Lorsque vous créez un projet à l’aide du modèle de 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 dont les attributs de service WCF sont appliqués. Ce fichier fournit une définition d’un service simple pour vous montrer comment définir vos services et inclut des opérations basées sur des paramètres et un exemple de contrat de données simple. Il s’agit du fichier par défaut affiché dans l’éditeur de code après avoir créé 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 d’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 pour le service et active l’échange de métadonnées.

Remarque

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 l’hôte de service WCF (WcfSvcHost.exe), qui est la configuration par défaut. Si vous hébergez la bibliothèque de services dans un exécutable, vous devez déplacer le code de configuration vers le fichier de configuration de l’exécutable, car 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 sous Visual C#\WCF et Visual Basic\WCF.

Lorsque vous créez un projet à l’aide du modèle de service d’application web WCF , le projet inclut les quatre fichiers suivants :

Fichier 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 héberge un service dans celui-ci.

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 le modèle d’application de service WCF, mais l’organise comme s’il s’agissait d’un site web ASP.NET. App_Code et les dossiers 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 offre un moyen rapide d’ajouter des services WCF à vos projets Visual Studio existants.

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

Les fichiers d’interface de service et 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 vers le fichier de configuration existant, s’ils sont des types compatibles.

Un fichier 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 flux de travail, qui est un flux de travail accessible comme un service web. Des modèles distincts existent pour les modèles de programmation XAML ou impératifs. À l’aide des modèles, vous pouvez créer un flux de travail d’ordinateur séquentiel ou d’état. Pour plus d’informations sur ces types de flux de travail, consultez Guide pratique pour créer un flux de travail. Pour plus d’informations sur la création de projets de flux de travail, consultez Création de projets de flux de travail hérités.

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

Modèle de bibliothèque de services de syndication WCF

Ce modèle vous 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 pendant l’exécution. Lorsque vous cliquez avec le bouton droit sur votre projet dans l’Explorateur de solutions dans Visual Studio, sélectionnez Propriétés, puis sélectionnez l’onglet Débogage et vous pouvez 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 modifier l’adresse sous l’onglet Débogage . Si ce n’est pas le cas, le navigateur tente d’ouvrir le flux à l’adresse par défaut et échoue.

Modèle d’élément de service WCF activé PAR 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 du contrôle AJAX.

Modèle d’élément de service WCF activé pour Silverlight

Ce modèle crée un service web qui fournit des données à un client Silverlight ou au serveur frontal. Le modèle peut être ajouté à un site web ou à un projet d’application web pour créer un service WCF, qui inclut le code de service et la configuration qui prennent en charge la communication avec un client Silverlight. Vous pouvez ensuite utiliser 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 activé par Silverlight.