Modèles Visual Studio WCF

Les modèles Visual Studio Windows Communication Foundation (WCF) sont des modèles d'élément et de projet prédéfinis que vous pouvez utiliser dans Visual Studio pour générer rapidement des services WCF et des applications s'y rapportant.

Utilisation des modèles WCF

Les modèles Visual Studio WCF 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.

Visual C++ 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), 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 de service d'application Web WCF

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

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.

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 Windows Workflow Foundation Tutorials. Pour plus d'informations sur le sujet suivant la création de projets de workflow, consultez Creating Workflow Projects.

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 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 Internet Explorer au cours de 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 cliquez sur l'onglet Débogage ; l'adresse par défaut du modèle s'affiche. Internet Explorer tente d'ouvrir le flux à cette adresse.

Si vous modifiez l'adresse de votre flux, vous devez aussi modifier l'adresse sous l'onglet Débogage. Sinon, Internet Explorer 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.

Visual Basic Remarque :

Le service WCF compatible Silverlight expose un point de terminaison basicHttpBinding sans activer de paramètre de sécurité. Par conséquent, les informations concernant le service peuvent être obtenues par tous les clients qui s'y connectent. Les messages échangés entre le service et le client ne sont pas signés ni chiffrés. Pour sécuriser correctement le point de terminaison, vous devez utiliser l'authentification ASP.NET, HTTPS ou d'autres mécanismes.

Voir aussi

Concepts

Hôte de service WCF (WcfSvcHost.exe)
Client test WCF (WcfTestClient.exe)