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)Windows Communication Foundation (WCF), le tester et y accéder à partir d'une application Windows Forms.This walkthrough demonstrates how to create a simple Windows Communication Foundation (WCF)Windows Communication Foundation (WCF) service, test it, and then access it from a Windows Forms application.

Note

Il est possible que pour certains des éléments de l’interface utilisateur de Visual Studio, votre ordinateur affiche des noms ou des emplacements différents de ceux indiqués dans les instructions suivantes.Your computer might show different names or locations for some of the Visual Studio user interface elements in the following instructions. L’édition de Visual Studio dont vous disposez et les paramètres que vous utilisez déterminent ces éléments.The Visual Studio edition that you have and the settings that you use, determine these elements. Pour plus d’informations, consultez Personnaliser l’IDE.For more information, see Personalize the IDE.

Créer le serviceCreate the service

Pour créer un service WCFTo create a WCF service

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

  2. Dans le nouveau projet boîte de dialogue, développez le Visual Basic ou Visual C# nœud et cliquez sur WCF, suivie WCF Bibliothèque de service.In the New Project dialog box, expand the Visual Basic or Visual C# node and click WCF, followed by WCF Service Library. Cliquez sur OK pour ouvrir le projet.Click OK to open the project.

    Projet Bibliothèque du service WCF

    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.

  3. Fichier IService1

    Dans l’Explorateur de solutions, double-cliquez sur IService1.vb ou IService1.cs et recherchez la ligne suivante :In Solution Explorer, double-click IService1.vb or IService1.cs and 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.

  4. Fichier Service1

    Dans l’Explorateur de solutions, double-cliquez sur Service1.vb ou Service1.cs et recherchez la ligne suivante :In Solution Explorer, double-click Service1.vb or Service1.cs and 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

Pour tester un service WCFTo test a WCF 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 Client Test WCF formulaire, double-cliquez sur le GetData() méthode 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 le demande boîte, sélectionnez le valeur champ et le type Hello.In the Request box, select the Value field and type Hello.

    Champ de valeur

  4. Cliquez sur le Invoke bouton.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. Sur le fichier menu, cliquez sur Exit pour fermer le formulaire de test.On the File menu, click Exit to close the test form.

Accéder au ServiceAccess the Service

Pour faire référence à un service WCFTo reference a WCF service

  1. Sur le fichier menu, 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. Avec le bouton droit WindowsApplication1 et 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 le ajouter une référence de Service boîte de dialogue, cliquez sur Discover.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.

Pour générer une application clienteTo build a client application

  1. Dans l’Explorateur de solutions, double-cliquez sur Form1.vb ou Form1.cs pour ouvrir le Concepteur de formulaires Windows s’il n’est pas déjà ouvert.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 un TextBox contrôle, un Label contrôle et un Button contrôle vers le formulaire.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, avec le bouton droit WindowsApplication1 et 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