Click here to Skip to main content
15,867,686 members
Articles / Programming Languages / Visual Basic
Tip/Trick

Hello World, Basic Server/Client Example of WCF

Rate me:
Please Sign up or sign in to vote.
4.97/5 (16 votes)
24 Aug 2013CPOL3 min read 173.2K   5.7K   21   11
Basic Server/Client Example using Windows Communication Foundation (WCF) programming

Introduction  

I want to make a very simple Server/Client application. Microsoft offers a great tool called Windows Communication Foundation (WCF) for communication between Server and Clients. I am trying to make a short introduction of WCF, but if you interested to know more, check out this link on MSDN for all details.
WCF has two parts:

  1. Services
  2. Clients

1) Services

Service has one or more endpoints. Endpoint means where message can receive or deliver. Service consists of a set of operations. Every service needs to host. There are four ways we can host and activate services:

  1. Windows Activation Service (WAS)
  2. As executables (.EXE), also called self-hosted service.
  3. Windows service
  4. COM+ components can also be hosted as WCF services

I am going to give a self-hosted service example here.
Self-Hosted Service has three parts to become live.

  1. Define a service contract
  2. Implement a service contract
  3. Host and run a service contract 

2) Clients 

WCF Clients is an application which can communicate with WCF Service operations as method.
Communicate with self-hosted service from WCF Clients has three steps:

  1. Create a WCF Client
  2. Configure a WCF Client
  3. Use a WCF Client

Background

I Googled and found lots of tutorials on WCF web hosting. Also most of them are in C#. Too much discussion on the technology. My aim is to make a WCF self-hosted service using VB.NET with a very basic example.

Using the Code

To make a WCF Service: Open Visual Studio 2010 

Image 1

Create a new WCF Service Library project. Name: myLib 

Image 2

Right mouse click on project name and select Add Reference.

Image 3

Select System.ServiceModel and click OK.

1) Define a service contract 
Now Open Service1.vb from Solution Explorer and copy this code:

VB.NET
' Service1
Imports System
Imports System.ServiceModel
 
Public Class Service1
 
    Implements IService1
 
    Public Function GetName(ByVal value As String) As String Implements IService1.GetData
        Console.WriteLine("Hello {0}", value)
        Return String.Format("Hello {0}", value)
    End Function
 
End Class  

2) Implement a service contract
Open IService1.vb from Solution Explorer and copy this code:
VB.NET
' IService1
Imports System
Imports System.ServiceModel
 

<ServiceContract()>
Public Interface IService1
 
    <OperationContract()>
    Function GetData(ByVal value As String) As String
 
End Interface


3) Host and run a service contract

Image 4

Add a new project to myLib Project:

Image 5

Select Console Application to display Host output. Name: wcHost

Image 6

Right mouse click on wcHost project and select Add Reference.

Image 7

From Add Reference Projects, select myLib and click OK.

Image 8

Again right mouse click on wcHost project and select Add Reference.

Image 9

Select System.ServiceModel and click OK.
Open Module1.vb from Solution Explorer and copy this code:

VB.NET
'Module1.vb
Imports System
Imports System.ServiceModel
Imports System.ServiceModel.Description
Imports myLib.Service1
 
Module Module1
 
    Sub Main()
        ' Step 1 Create a URI to serve as the base address
        Dim baseAddress As New Uri("http://localhost:8000/SayHelloService")
 
        ' Step 2 Create a ServiceHost instance
        Dim selfHost As New ServiceHost(GetType(myLib.Service1), baseAddress)
        Try
 
            ' Step 3 Add a service endpoint
            ' Add a service endpoint
            selfHost.AddServiceEndpoint(GetType(myLib.IService1), _
            New WSHttpBinding(), "HelloService")
 
            ' Step 4 Enable metadata exchange.
            Dim smb As New ServiceMetadataBehavior()
            smb.HttpGetEnabled = True
            selfHost.Description.Behaviors.Add(smb)
 
            ' Step 5 Start the service
            selfHost.Open()
            Console.WriteLine("The service is ready.")
            Console.WriteLine("Press <ENTER> to terminate service.")
            Console.WriteLine()
            Console.ReadLine()
 
            ' Close the ServiceHostBase to shutdown the service.
            selfHost.Close()
        Catch ce As CommunicationException
            Console.WriteLine("An exception occurred: {0}", ce.Message)
            selfHost.Abort()
        End Try
    End Sub
 
End Module

Build wcHost

To make a WCF Client: Open Visual Studio 2010

1) Create a WCF Client
 

Image 10

Create a new console application. Name: wcClient

Image 11

Right mouse click on project name and select Add Reference.

Image 12

Select System.ServiceModel and click OK:

Image 13

Right mouse click on project name and select Add Service Reference.

Image 14

Put "http://localhost:8000/SayHelloService" in address.
Now run wcHost.exe, you can locate it in ..\wcHost\bin\Debug folder.
When wcHost runs, then click go in add service reference window and wait.

Image 15

When found Service1 then Click OK.
2)Configure a WCF ClientOpen wcClient app.config from Solution Explorer and copy this code:

VB.NET
<?xml version="1.0" encoding="utf-8" ?>
<configuration>
    <system.diagnostics>
        <sources>
            <!-- This section defines the logging configuration for My.Application.Log -->
            <source name="DefaultSource" switchName="DefaultSwitch">
                <listeners>
                    <add name="FileLog"/>
                    <!-- Uncomment the below section to write to the Application Event Log -->
                    <!--<add name="EventLog"/>-->
                </listeners>
            </source>
        </sources>
        <switches>
            <add name="DefaultSwitch" value="Information" />
        </switches>
        <sharedListeners>
            <add name="FileLog"
                 type="Microsoft.VisualBasic.Logging.FileLogTraceListener, Microsoft.VisualBasic, Version=8.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a, processorArchitecture=MSIL"
                 initializeData="FileLogWriter"/>
            <!-- Uncomment the below section and replace APPLICATION_NAME with the name of your application to write to the Application Event Log -->
            <!--<add name="EventLog" type="System.Diagnostics.EventLogTraceListener" initializeData="APPLICATION_NAME"/> -->
        </sharedListeners>
    </system.diagnostics>
    <system.serviceModel>
        <bindings>
            <wsHttpBinding>
                <binding name="WSHttpBinding_IService1" />
            </wsHttpBinding>
        </bindings>
        <client>
            <endpoint address="http://localhost:8000/SayHelloService/HelloService"
                binding="wsHttpBinding" bindingConfiguration="WSHttpBinding_IService1"
                contract="ServiceReference1.IService1" name="WSHttpBinding_IService1">
                <identity>
                    <userPrincipalName value="ERP001\Manager1" />
                </identity>
            </endpoint>
        </client>
    </system.serviceModel>
</configuration>
 

Note: Please change  "ERP001\Manager1" according to your Server Computer user name in <identity> section of app.config file.


3) Use a WCF Client

Open wcClient Module1.vb from Solution Explorer and copy this code: 

VB.NET
'Client Module1
Imports System
Imports System.ServiceModel
Imports wcClient.ServiceReference1
 

Module Module1
    Dim Client As New Service1Client
 
    Sub Main()
        Console.WriteLine("Client Window")
        Console.WriteLine("{0}", Client.GetData(Console.ReadLine()))
 
        ' Step 3: Closing the client gracefully closes the connection and cleans up resources.
        Client.Close()
 
        Console.WriteLine()
        Console.WriteLine("Press <ENTER> to terminate client.")
        Console.ReadLine()
 
    End Sub
 
End Module

Build and run wcClient.exe:

Image 16

Enter "World" in wcClient window. 

Points of Interest

Visual Studio by default created two files service1.vb and Iservice1.vb when we create wcHost. If you rename the default file name or class name make sure you update all reference in entire solution. I use simple replace command from vs edit menu look into entire solution to replace "service" class name with "xxx" so that all the reference get updated. but you can do it manually. Just make sure you update all reference.

License

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)


Written By
Software Developer (Senior)
Bangladesh Bangladesh
I am very positive about life and a born explorer. I set my personal goal to be a good human being,

Comments and Discussions

 
Questionwhats this please? SayHelloService Pin
ar-b30-Nov-18 7:27
ar-b30-Nov-18 7:27 
hi dear Hasan
I appreciate you for your article
excuse me what is this ??
/SayHelloService/HelloService


and where are there in the solution??

thanks a lot
QuestionThanks!!! Pin
waldodj8-Jul-15 10:07
waldodj8-Jul-15 10:07 
QuestionUnable to locate Service Referenc3 Pin
stp6623-Jul-14 5:15
stp6623-Jul-14 5:15 
AnswerRe: Unable to locate Service Referenc3 Pin
Hasan Habib Surzo1-Sep-14 22:00
Hasan Habib Surzo1-Sep-14 22:00 
QuestionClear example Pin
ugo.marchesini30-Apr-14 5:33
professionalugo.marchesini30-Apr-14 5:33 
QuestionClient and Server hosted in two different computers Pin
codertuhin3-Jan-14 17:30
codertuhin3-Jan-14 17:30 
AnswerRe: Client and Server hosted in two different computers Pin
Hasan Habib Surzo3-Jan-14 17:56
Hasan Habib Surzo3-Jan-14 17:56 
GeneralRe: Client and Server hosted in two different computers Pin
codertuhin3-Jan-14 18:43
codertuhin3-Jan-14 18:43 
GeneralMy vote of 5 Pin
ridoy25-Aug-13 23:38
professionalridoy25-Aug-13 23:38 
GeneralMy vote of 5 Pin
Monjurul Habib25-Aug-13 23:15
professionalMonjurul Habib25-Aug-13 23:15 
GeneralMy vote of 5 Pin
Member 1023104225-Aug-13 7:16
Member 1023104225-Aug-13 7:16 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.