Procédure pas à pas : créer un service WPF simple dans Windows Forms .NET Framework

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

Remarque

Dans cet article, il est possible que votre ordinateur affiche des noms ou des emplacements différents pour certains éléments de l’interface utilisateur Visual Studio. Il se peut que vous utilisiez une autre édition de Visual Studio ou d’autres paramètres d’environnement. Pour plus d’informations, consultez Personnaliser l’IDE.

Prérequis

Les outils WCF ne sont pas installés avec la charge de travail .NET. Utilisez Visual Studio Installer pour modifier votre installation. Dans le programme d’installation, choisissez Windows Communication Foundation sous Composants individuels. Consultez Modifier Visual Studio.

Créer un service

1. Ouvrez Visual Studio.

2. Dans la fenêtre de démarrage, choisissez Créer un projet.

3. Tapez bibliothèque de service wcf dans la zone de recherche de la page Créer un projet. Sélectionnez le modèle C# ou Visual Basic pour la bibliothèque de services WCF, puis sélectionnez Suivant.

   

   Conseil

   Si vous ne voyez aucun modèle, vous devrez peut-être installer le composant Windows Communication Foundation de Visual Studio. Choisissez Installer d’autres outils et fonctionnalités pour ouvrir Visual Studio Installer. Choisissez l’onglet Composants individuels, faites défiler jusqu’à Activités de développement, puis sélectionnez Windows Communication Foundation. Cliquez sur Modifier.

4. Dans la page Configurer votre nouveau projet, cliquez sur Créer.

   Notes

   Un service actif est créé, qui peut être testé et est accessible. Les deux étapes suivantes montrent comment vous pouvez modifier la méthode par défaut pour utiliser un autre type de données. Dans une application réelle, vous ajouteriez également vos propres fonctions au service.

5. Dans l’Explorateur de solutions, double-cliquez sur IService1.vb ou IService1.cs.

   

   Recherchez la ligne suivante :

   C#

   [OperationContract]
   string GetData(int value);
   

   VB

   <OperationContract()>
   Function GetData(ByVal value As Integer) As String
   

---

Modifiez le type du paramètre value en chaîne :

C#

[OperationContract]
string GetData(string value);

VB

<OperationContract()>
Function GetData(ByVal value As String) As String

Dans le code ci-dessus, notez l’attribut OperationContract. Cet attribut est requis pour toutes les méthodes exposées par le service.

6. Dans l’Explorateur de solutions, double-cliquez sur Service1.vb ou Service1.cs.

   

   Recherchez la ligne suivante :

   C#

   public string GetData(int value)
   {
       return string.Format("You entered: {0}", value);
   }
   

   VB

   Public Function GetData(ByVal value As Integer) As String Implements IService1.GetData
       Return String.Format("You entered: {0}", value)
   End Function
   

---

Modifiez le type du paramètre value en chaîne :

C#

public string GetData(string value)
{
    return string.Format("You entered: {0}", value);
}

VB

Public Function GetData(ByVal value As String) As String Implements IService1.GetData
    Return String.Format("You entered: {0}", value)
End Function

Testez le service

1. Appuyez sur F5 pour exécuter le service. Un formulaire Client de test WCF s’affiche et charge le service.

2. Dans le formulaire Client test WCF, 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éder au service

Référencer le service WCF

1. Dans le menu Fichier, pointez sur Ajouter > Nouveau projet. Choisissez un projet Windows Forms App (.NET Framework).

2. Cliquez avec le bouton droit sur le nœud du projet et cliquez sur Ajouter > Référence de service. La boîte de dialogue Ajouter une référence de service s'affiche.

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

   

   Service1 s’affiche dans le volet Services.

4. Cliquez sur OK pour ajouter la référence de service.

Création d'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 ne l’est pas déjà.

2. Ouvrez la Boîte à outils en cliquant sur Afficher> Boîte à outils (ou Ctrl+Alt+X sur le clavier).

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

   

4. Double-cliquez sur le contrôle Button, puis ajoutez le code suivant au gestionnaire d'événements Click :

   C#

   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;
   }
   

   VB

     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
   

5. Dans Explorateur de solutions, cliquez avec le bouton droit sur le nœud du projet (par exemple, WindowsFormsApp1), puis sur Définir comme projet de start-up.

6. Appuyez sur F5 pour exécuter le projet. Entrez un texte et cliquez sur le bouton. Le message « Vous avez entré : » s’affichera, suivi du texte que vous avez entré.

   

Contenu connexe

• Services Windows Communication Foundation et services de données WCF dans Visual Studio