Procédure pas à pas : Créer un service WCF simple dans les Windows FormsWalkthrough: Create a simple WCF service in Windows Forms

Cette procédure pas à pas montre comment créer un simple service Windows Communication Foundation (WCF), testez-la, puis y accéder à partir d’une application Windows Forms.This walkthrough demonstrates how to create a simple Windows Communication Foundation (WCF) service, test it, and then access it from a Windows Forms application.

Note

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.Your computer might show different names or locations for some of the Visual Studio user interface elements in this article. Vous utilisez peut-être une autre édition de Visual Studio ou d’autres paramètres d’environnement.You may be using a different edition of Visual Studio or different environment settings. Pour plus d’informations, consultez Personnaliser l’IDE.For more information, see Personalize the IDE.

Créer un serviceCreate a service

  1. Ouvrez Visual Studio.Open Visual Studio.
  1. Dans le menu Fichier , choisissez Nouveau > Projet.On the File menu, choose New > Project.

  2. Dans le nouveau projet boîte de dialogue, développez le Visual Basic ou Visual C# nœud et choisissez WCF, suivie de Bibliothèque du Service WCF.In the New Project dialog box, expand the Visual Basic or Visual C# node and choose WCF, followed by WCF Service Library.

  3. Cliquez sur OK pour créer le projet.Click OK to create the project.

    Projet Bibliothèque du service WCF

  1. Dans la fenêtre de démarrage, choisissez Créer un projet.On the start window, choose Create a new project.

  2. Type bibliothèque du service wcf dans la zone de recherche sur le créer un nouveau projet page.Type wcf service library in the search box on the Create a new project page. Sélectionnez le C# ou un modèle de Visual Basic pour bibliothèque du Service WCF, puis cliquez sur suivant.Select either the C# or Visual Basic template for WCF Service Library, and then click Next.

    Créer un nouveau projet de bibliothèque de Service WCF dans Visual Studio 2019

    Tip

    Si vous ne voyez pas tous les modèles, vous devrez peut-être installer le Windows Communication Foundation composant de Visual Studio.If you don't see any templates, you may need to install the Windows Communication Foundation component of Visual Studio. Choisissez installer d’autres outils et fonctionnalités pour ouvrir le programme d’installation de Visual Studio.Choose Install more tools and features to open Visual Studio Installer. Choisissez le composants individuels onglet, faites défiler jusqu'à activités de développement, puis sélectionnez Windows Communication Foundation.Choose the Individual components tab, scroll down to Development activities, and then select Windows Communication Foundation. Cliquez sur Modifier.Click Modify.

  3. Sur le configurer votre nouveau projet , cliquez sur créer.On the Configure your new project page, click Create.

Note

Un service actif est créé, qui peut être testé et est accessible.This creates a working service that can be tested and accessed. Les deux étapes suivantes montrent comment vous pouvez modifier la méthode par défaut pour utiliser un autre type de données.The following two steps demonstrate how you might modify the default method to use a different data type. Dans une application réelle, vous ajouteriez également vos propres fonctions au service.In a real application, you would also add your own functions to the service.

  1. Dans l’Explorateur de solutions, double-cliquez sur IService1.vb ou IService1.cs.In Solution Explorer, double-click IService1.vb or IService1.cs.

    Fichier IService1

    Recherchez la ligne suivante :Find the following line:

    [OperationContract]
    string GetData(int value);
    
    <OperationContract()>
    Function GetData(ByVal value As Integer) As String
    

    Modifier le type de le value paramètre en chaîne :Change the type for the value parameter to string:

    [OperationContract]
    string GetData(string value);
    
    <OperationContract()>
    Function GetData(ByVal value As String) As String
    

    Dans le code ci-dessus, notez les attributs <OperationContract()> ou [OperationContract].In the above code, note the <OperationContract()> or [OperationContract] attributes. Ces attributs sont obligatoires pour toute méthode exposée par le service.These attributes are required for any method exposed by the service.

  2. Dans l’Explorateur de solutions, double-cliquez sur Service1.vb ou Service1.cs.In Solution Explorer, double-click Service1.vb or Service1.cs.

    Fichier Service1

    Recherchez la ligne suivante :Find the following line:

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

    Modifier le type de le value paramètre en chaîne :Change the type for the value parameter to string:

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

Tester le serviceTest the service

  1. Appuyez sur F5 pour exécuter le service.Press F5 to run the service. Un Client Test WCF formulaire s’affiche et charge le service.A WCF Test Client form appears and loads the service.

  2. Dans le formulaire Client test WCF, double-cliquez sur la méthode GetData() sous IService1.In the WCF Test Client form, double-click the GetData() method under IService1. Le GetData onglet s’affiche.The GetData tab appears.

    La méthode GetData( ) (méthode)

  3. Dans la zone Demande, sélectionnez le champ Valeur et tapez Hello.In the Request box, select the Value field and type Hello.

    Champ de valeur

  4. Cliquez sur le bouton Appeler.Click the Invoke button. Si un avertissement de sécurité boîte de dialogue s’affiche, cliquez sur OK.If a Security Warning dialog box appears, click OK. Le résultat s’affiche dans le réponse boîte.The result displays in the Response box.

    Résultat dans la zone Réponse

  5. Dans le menu Fichier, cliquez sur Quitter pour fermer le formulaire de test.On the File menu, click Exit to close the test form.

Accéder au ServiceAccess the Service

Référence au service WCFReference the WCF service

  1. Dans le menu Fichier, pointez sur Ajouter, puis cliquez sur Nouveau projet.On the File menu, point to Add and then click New Project.

  2. Dans le nouveau projet boîte de dialogue, développez le Visual Basic ou Visual C# nœud, sélectionnez Windows, puis sélectionnez Windows Forms Application.In the New Project dialog box, expand the Visual Basic or Visual C# node, select Windows, and then select Windows Forms Application. Cliquez sur OK pour ouvrir le projet.Click OK to open the project.

    Projet Application Windows Forms

  3. Cliquez avec le bouton droit sur WindowsApplication1, puis cliquez sur Ajouter une référence de service.Right-click WindowsApplication1 and click Add Service Reference. Le ajouter une référence de Service boîte de dialogue s’affiche.The Add Service Reference dialog box appears.

  4. Dans la boîte de dialogue Ajouter une référence de service, cliquez sur Découvrir.In the Add Service Reference dialog box, click Discover.

    Boîte de dialogue Ajouter une référence de service

    Service1 affiche dans le Services volet.Service1 displays in the Services pane.

  5. Cliquez sur OK pour ajouter la référence de service.Click OK to add the service reference.

Création d'une application clienteBuild a client application

  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à.In Solution Explorer, double-click Form1.vb or Form1.cs to open the Windows Forms Designer if it is not already open.

  2. À partir de la boîte à outils, faites glisser vers le formulaire un contrôle TextBox, un contrôle Label et un contrôle Button.From the Toolbox, drag a TextBox control, a Label control, and a Button control onto the form.

    Ajout de contrôles au formulaire

  3. Double-cliquez sur le contrôle Button, puis ajoutez le code suivant au gestionnaire d'événements Click :Double-click the Button, and add the following code in the Click event handler:

    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;
    }
    
      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
    
  4. Dans l’Explorateur de solutions, cliquez avec le bouton droit sur WindowsApplication1, puis cliquez sur Définir comme projet de démarrage.In Solution Explorer, right-click WindowsApplication1 and click Set as StartUp Project.

  5. Appuyez sur F5 pour exécuter le projet.Press F5 to run the project. Entrez un texte et cliquez sur le bouton.Enter some text and click the button. L’étiquette affiche « vous avez entré : » et affiche le texte que vous avez entré.The label displays "You entered:" and shows the text that you entered.

    Formulaire affichant le résultat

Voir aussiSee also