This article shows how we can debug a WCF Service in Visual Studio which is hosted in a Windows Service with netTcpBinding.
As we know when we create a WCF Service as a class library in Visual Studio and run the service, we don't need a host (like Self-Hosting App, Windows Services, IIS or WAS). Right? It happens because fortunately Microsoft has already included a small testing service host and a test client in order to ease development and testing of WCF services. Press F5 in Visual Studio and you are set to start debugging by setting a breakpoint anywhere in the service where we want to. You would see the following message when the WCF Service runs:
But suppose we host our WCF service in a Windows Service and make the Windows Service as our main start up project, then it becomes difficult to debug our WCF Service because then the Windows Service is the main driving application (host) which doesn't allow running the WCF Service by a debugger.
It gives the following error message if you try to do that:
So what is the solution? For this problem, we have the following simple remedial options:
- Through Visual Studio: In this option (which I am not going to discuss here), you need to open your Visual Studio in administrative mode and you have to have your Service attached to the process. For more details of that, see the MSDN article:
- Through Code: We are going to discuss this option in detail in this article.
To explain this, I divided this article into the following sections:
- Creating a small WCF Service with netTcpBinding
- Creating Windows Service Host
- Setting a Windows Service that enables debugging in Visual Studio
- Creating our own Test Client
1. Creating a small WCF Service with netTcpBinding
- On the File menu, point to New and then click Project.
- In the New Project dialog box, expand the Visual C# node and click WCF, followed by WCF Service Library. Click OK to open the project.
- A builtin WCF Service with two operation contracts (by default) is created for you by Visual Studio. You don't need to change any operation contract or data contract because here our focus is not to learn how to create a WCF Service and their contracts (operation/Data).
- For netTcpBinding, we need to change the contents of the default app.Config file as:
<endpoint address="" binding="netTcpBinding" bindingConfiguration=""
<dns value="localhost" />
<endpoint address="mex" binding="mexTcpBinding" bindingConfiguration=""
<add baseAddress="net.tcp://localhost:8732/Design_Time_Addresses/MyWcfService/Service1/" />
<!-- To avoid disclosing metadata information,
set the value below to false and remove the metadata endpoint above before deployment -->
<!-- To receive exception details in faults for debugging purposes,
set the value below to true. Set to false before deployment
to avoid disclosing exception information -->
<serviceDebug includeExceptionDetailInFaults="True" />
- That's it! We are done with creating our Test WCF Service.
2. Creating a Windows Service Host
Now we create a Windows Service project in Visual Studio:
- On the File menu, point to New and then click Project.
- In the New Project dialog box, expand the Windows node and click Window Service and Click OK to open the project.
- A default Window service project is created.
- Although this step is optional right now, eventually we would end up doing this because we want to install our Windows Service into the system. For this, we need to add a project installer into our windows service so that we can install our windows service using the "regsvr32" command. In order to do that, we go to the designer of Service1.cs and:
- Right-click in the designer of Service1.cs. Choose the "Add Installer" option from the menu.
- Visual Studio automatically creates a ProjectInstallar for us.
- Give any name to your service in the properties window of serviceInstaller1.
- For how we can install any windows service using the "installutil" command, we could go to the following MSDN link:
- Add the WCF Service DLL reference into the Window Service project.
- Add a System.ServiceModel reference to the Windows Service
- Open the Service1.cs file and create WCF Service host into the OnStart() method as follows:
public partial class Service1 : ServiceBase
} protected override void OnStart(string args)
Type serviceType = typeof(MyWcfService.Service1);
host = new ServiceHost(serviceType);
protected override void OnStop()
- Add a new "app.config" file into the Windows Service Project.
- Copy the same contents of the WCF service app.config (described in section1.4) into our newly added Windows Service app.config file.
3. Setting Windows Service that enables debugging in Visual Studio
Open the Program.cs file of the Windows Service Host Application and replace the existing Program.cs with the following code:
- In the following code, we created an instance of the "Service1" class of the Windows Service and explicitly called our own methods: OnDebugMode_Start() and OnDebugMode_Stop().
- This portion will be run only in DEBUG Mode since we used the #if DEBUG directive.
- The portion in the #else block will not be run in DEBUG Mode.
- We also put the Main Thread into an infinite time Sleep Mode in order to make "Debugging" available continuosuly until we want.
Note: When we want to install this Windows service using the "installutil" command, we have to comment out the #if DEBUG directive and its code as in the following:
static void Main()
System.Threading.Thread.CurrentThread.Name = "ServiceMain";
//// Run as interactive exe in debug mode to allow easy debugging.
//var service = new Service1();
//// Sleep the main thread indefinitely while the service code runs in OnStart()
ServicesToRun = new ServiceBase
catch (Exception exc)
Open the Service1.cs file and add two more public methods in the same class, which basically calls the OnStart() and OnStop() methods internally:
public void OnDebugMode_Start()
public void OnDebugMode_Stop()
Windows Service is in debugger mode, it won't complain as in Figure 2.
Press F5 to run the service and make sure the service is running properly. Since
4. Creating our own Test Client
- Create any WinForm Application or Console Application to be a client of our WCF Service which will consume the WCF Service.
- Make sure WCF Service is running.
- Right-click the Reference tab of your project. Click "Add a ServiceReference".
- The Add Service Reference Window will open
- Put the WCF Endpoint base address (copying from app.config) into the Address bar of the Window.
- Click Go. It must have found out our WCF Service interfaces.
- Click OK. In this way, you added a service reference to you client project.
- Create a Proxy Client Object of your WCF Service as:
ServiceReference1.Service1Client objectProxyClient = new Service1Client();
- Access interfaces of the WCF Service with an "objectProxyClient" object.
So, here we learned how to easily debug a WCF Service in Visual Studio which is hosted in a Window Service by making a small Test WCF Service with netTcpBinding, hosting a Windows Service and Test Client Tool.