Procédure pas à pas : création et utilisation des services WCF

Mise à jour : Juillet 2008

Cette procédure pas à pas montre comment créer un service Windows Communication Foundation (WCF) simple, le tester puis y accéder à partir d'une application Windows Forms.

Remarque :
Il est possible que votre ordinateur affiche des noms ou des emplacements différents pour certains des éléments d'interface utilisateur Visual Studio dans les instructions suivantes. L'édition de Visual Studio dont vous disposez et les paramètres que vous utilisez déterminent ces éléments. Pour plus d'informations, consultez Paramètres Visual Studio.

Création du service

Pour créer un service WCF

1. Dans le menu Fichier, pointez sur Nouveau, puis cliquez sur Projet.

2. Dans la boîte de dialogue Nouveau projet, développez le nœud Visual Basic ou Visual C# et cliquez sur WCF, puis Bibliothèque de services WCF. Cliquez sur OK pour ouvrir le projet.

   Remarque :
   Cela crée un service de travail qui pourrait être effectivement testé et auquel on pourrait accéder. Les deux étapes suivantes montrent comment vous pourriez modifier la méthode par défaut pour utiliser un type de données différent. Dans une application réelle, vous ajouteriez également vos propres fonctions au service.

3. Dans l'Explorateur de solutions, double-cliquez sur IService1.vb ou IService1.cs et recherchez la ligne suivante :

   Function GetData(ByVal value As Integer) As String
   string GetData(int value);
   

   Modifiez le type du paramètre value en String :

   Function GetData(ByVal value As String) As String
   string GetData(string value);
   

4. Dans l'Explorateur de solutions, double-cliquez sur Service1.vb ou Service1.cs et recherchez la ligne suivante :

   Public Function GetData(ByVal value As Integer) As String _
   Implements IService1.GetData
   public string GetData(int value)
   

   Modifiez le type pour le paramètre de valeur en String :

   Public Function GetData(ByVal value As String) As String _
   Implements IService1.GetData.
   public string GetData(string value)
   

Test du Service

Pour tester un service WCF

1. Appuyez sur F5 pour exécuter le service. Un formulaire WCF Test Client s'affiche et charge le service.

2. Dans le formulaire WCF Test Client, double-cliquez sur la méthode GetData() sous IService1. L'onglet GetData s'affiche.

3. Dans la zone Demande, sélectionnez le champ Valeur et tapez Hello.

4. Cliquez sur le bouton Appeler. Si une boîte de dialogue Avertissement de sécurité s'affiche, cliquez sur OK. Le résultat s'affiche dans la zone Réponse.

5. Dans le menu Fichier, cliquez sur Quitter pour fermer le formulaire de test.

Accès au service

Pour référencer un service WCF

1. Dans le menu Fichier, pointez sur Ajouter, puis cliquez sur Nouveau projet.

2. Dans la boîte de dialogue Nouveau projet, développez le nœud Visual Basic ou Visual C# et sélectionnez Windows, puis Application Windows Forms. Cliquez sur OK pour ouvrir le projet.

3. Cliquez avec le bouton droit sur WindowsApplication1 et cliquez sur Ajouter une référence de service. La boîte de dialogue Ajouter une référence de service s'affiche.

4. Dans la boîte de dialogue Ajouter une référence de service, cliquez sur Découvrir.

   Service1 est affiché dans le volet Services.

5. Cliquez sur OK pour ajouter une référence de service.

Pour générer une application cliente

1. Dans l'Explorateur de solutions, double-cliquez sur Form1.vb ou Form1.cs pour ouvrir le Concepteur Windows Forms s'il n'est pas déjà ouvert.

2. À partir de la boîte à outils, faites glisser un contrôle TextBox, un contrôle Label et un contrôle Button sur le formulaire.

3. Double-cliquez sur le Button et ajoutez le code suivant au gestionnaire d'événements Click :

   Private Sub Button1_Click(ByVal sender As System.Object, _
     ByVal e As System.EventArgs) Handles Button1.Click
       Dim client As New ServiceReference1.Service1Client
       Dim returnString As String
   
       returnString = client.GetData(TextBox1.Text)
       Label1.Text = returnString
   End Sub
   private void button1_Click(System.Object sender, System.EventArgs e)
   {
       ServiceReference1.Service1Client client = new 
           ServiceReference1.Service1Client();
       string returnString;
   
       returnString = client.GetData(textBox1.Text);
       label1.Text = returnString;
   }
   

4. Dans l'Explorateur de solutions, cliquez avec le bouton droit sur WindowsApplication1, puis cliquez sur Définir comme projet de démarrage.

5. Appuyez sur F5 pour exécuter le projet. Entrez du texte et cliquez sur le bouton. L'étiquette « Vous avez entré : » plus le texte que vous avez entré s'affiche.

Voir aussi

Tâches

Consommation de services ASMX et WCF, exemple

Historique des modifications