Walkthrough: Create a simple WCF service in Windows Forms

Applies to: Visual Studio Visual Studio for Mac

This walkthrough demonstrates how to create a simple Windows Communication Foundation (WCF) service, test it, and then access it from a .NET Framework Windows Forms application.

Prerequisites

The WCF tools are not installed with the .NET workload; use the Visual Studio Installer to modify your installation. In the installer, choose Windows Communication Foundation under Individual Components. See Modify Visual Studio.

Create a service

1. Open Visual Studio.

5. In Solution Explorer, double-click IService1.vb or IService1.cs.

   

   Find the following line:

   [OperationContract]
   string GetData(int value);
   

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

   Change the type for the value parameter to string:

   [OperationContract]
   string GetData(string value);
   

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

   In the above code, note the OperationContract attribute. This attribute is required for any method exposed by the service.

6. In Solution Explorer, double-click Service1.vb or Service1.cs.

   

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

   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
   

Test the service

1. Press F5 to run the service. A WCF Test Client form appears and loads the service.

2. In the WCF Test Client form, double-click the GetData() method under IService1. The GetData tab appears.

   

3. In the Request box, select the Value field and type Hello.

   

4. Click the Invoke button. If a Security Warning dialog box appears, click OK. The result displays in the Response box.

   

5. On the File menu, click Exit to close the test form.

Access the Service

Reference the WCF service

1. On the File menu, point to Add and then click New Project.

2. In the New Project dialog box, expand the Visual Basic or Visual C# node, select Windows, and then select Windows Forms Application. Click OK to open the project.

   

3. Right-click WindowsApplication1 and click Add Service Reference. The Add Service Reference dialog box appears.

4. In the Add Service Reference dialog box, click Discover.

   

   Service1 displays in the Services pane.

5. Click OK to add the service reference.

Build a client application

1. In Solution Explorer, double-click Form1.vb or Form1.cs to open the Windows Forms Designer if it is not already open.

2. From the Toolbox, drag a TextBox control, a Label control, and a Button control onto the form.

   

3. 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. In Solution Explorer, right-click WindowsApplication1 and click Set as StartUp Project.

5. Press F5 to run the project. Enter some text and click the button. The label displays "You entered:" and shows the text that you entered.

   

See also

• Windows Communication Foundation Services and WCF Data Services in Visual Studio