Click here to Skip to main content
15,860,972 members
Articles / Programming Languages / C#
Article

Debugging Windows Service Without Deploying It

Rate me:
Please Sign up or sign in to vote.
4.85/5 (25 votes)
10 Dec 2007CPOL3 min read 84.6K   1.8K   72   11
This article decribes an easy way to debug Windows Services without having to deploy it.
Screenshot - EasyDebugWindowsServices.JPG

Introduction

At the beginning, there was no easy way to build a Windows service using Visual Studio and .NET Framework. Now that Microsoft has integrated this functionality as a template and a class library, it's much more easy to do that. This is good, but to test your newly created service you have to deploy it. That means you must add an installer and build a whole MSI file and run it in your environment. Once deployed, you can start it with Windows Service controller and attach a debugger to it.

I don't know how this sounds to you, but to me it is too much unneeded work to do a quick test. This article describes a much more easy way to do that.

Using the Code

You will find a sample application using this concept. Here is how it works.

First you need a working Windows service. (For more information, refer to this.)

In Visual Studio, building a Web service is easy. Create a new project and select Windows Service template.

Then add ServiceDebuggerHelper project to your solution and a reference to it. You can find it in the sample code.

By default, when you create a Windows service project, Visual Studio will create two classes: a Program class and a Service1 class. Here is what the program class looks like:

C#
static class Program 
{ 
    /// <summary>
    /// The main entry point for the application. 
    /// </summary>
    static void Main() 
    { 
        ServiceBase[] ServicesToRun = new ServiceBase[] { new Service1() }; 
        ServiceBase.Run(ServicesToRun); 
    } 
}

The first thing we have to do is to surround that code with a conditional statement to let us control if we want to run as a real service or just in debugging mode.

C#
 static class Program 
{ 
    /// <summary>
    /// The main entry point for the application. 
    /// </summary>
    static void Main() 
    { 
        if (args.Length > 0 && args[0].ToLower().Equals("/debug")) 
        { 
            Application.Run(new ServiceRunner(new Service1())); 
        } 
        else 
        {        
            ServiceBase[] ServicesToRun = new ServiceBase[] { new Service1() }; 
            ServiceBase.Run(ServicesToRun); 
        }
    } 
}

In this new Program class, ServiceRunner will be acting as a service host. To make it work, you have to add the "/debug" command line option in your project properties.

Go to Project -> ... Properties -> Debug and type /debug in the command line arguments field.

From there, you have two options to make your service debuggable. Either you implement IDebuggableService or inherit from DebuggableService base class.

Implementing IDebuggableService Interface

If you already subclass ServiceBase and use that subclass for all your services or if you just want to have full control over the implementation, you should implement the IDebuggableService interface. Here is its definition:

C#
public interface IDebuggableService
{
    void Start(string[] args);
    void StopService();
    void Pause();
    void Continue();
}

Notice that the stop method is called StopService to avoid conflict with the existing Stop method of the ServiceBase class.

Here is a sample implementation of this interface:

C#
public partial class Service1 : ServiceBase, IDebuggableService        
{
    //
    // Your existing service code
    //
    // ...
    //
    
    #region IDebuggableService Members

    public void Start(string[] args)
    {
        OnStart(args);
    }

    public void StopService()
    {
        OnStop();
    }

    public void Pause()
    {
        OnPause();
    }

    public void Continue()
    {
        OnContinue();
    }

    #endregion
}

Subclassing DebuggableService

Subclassing your service from DebuggableService is even more simple. All you have to do is change the base class from ServiceBase to DebuggableService.

C#
public partial class Service1 : DebuggableService        
{
    //
    // Your existing service code
    //
    // ...
    //
}

All the control methods are already implemented by DebuggableService.

Points of Interest

In my sample code, I added a Windows Form class to let you start, stop and pause your service. You can use it as is, build your own controller interface or just call the methods in your program class. It is up to you.

Of course you should still deploy your service to give it the final test run. One good reason to do this is to test the actual security context in which your service will run. It will not have the same permission as when you run it in Visual Studio, but this technique can speed up the development process.

License

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


Written By
Architect Orckestra
Canada Canada
Eric De Carufel is a .NET solution architect for Orckestra in Montreal. He is a specialist in application development with Microsoft .NET framwork. He has more than fifteen years of experience in software design in various domain as transportation, food store, insurance, engineering, finance and electronic business. Eric is memeber of Groupe d'usagers Visual Studio .NET de Montreal at which he gave some presentation. Eric is a Microsoft certified developer (Microsoft Certified Application Developer - MCAD)

Comments and Discussions

 
GeneralMy vote of 5 Pin
Akram El Assas8-Oct-12 4:40
Akram El Assas8-Oct-12 4:40 
GeneralMy vote of 5 Pin
Volynsky Alex10-Jul-12 9:33
professionalVolynsky Alex10-Jul-12 9:33 
GeneralMy vote of 5 Pin
VirtualVoid.NET13-Oct-10 1:20
VirtualVoid.NET13-Oct-10 1:20 
QuestionDoes this even compile? Pin
Frode Nesbakken23-Oct-09 14:08
Frode Nesbakken23-Oct-09 14:08 
AnswerRe: Does this even compile? Pin
Raithlin13-Oct-10 2:20
Raithlin13-Oct-10 2:20 
GeneralThoughts Pin
PIEBALDconsult11-Aug-09 21:05
mvePIEBALDconsult11-Aug-09 21:05 
GeneralGreat solution Pin
mishenkovks21-Feb-08 3:43
mishenkovks21-Feb-08 3:43 
GeneralRe: Great solution Pin
J0J0_28-Jun-08 11:06
J0J0_28-Jun-08 11:06 
GeneralRe: Great solution Pin
Caldas5-Jan-10 4:16
Caldas5-Jan-10 4:16 
Generalminor typo [modified] Pin
Tobias Manthey22-Jan-08 5:56
Tobias Manthey22-Jan-08 5:56 
GeneralIDebuggableService Documentation Pin
Jeffrey Walton7-Dec-07 1:55
Jeffrey Walton7-Dec-07 1:55 

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.