How to: Debug the OnStart Method

This topic applies to:

Edition	Visual Basic	C#	C++	Web Developer
Express			Managed only
Standard			Managed only
Pro and Team			Managed only

Table legend:

	Applies
	Does not apply
	Command or commands hidden by default.

You can debug the constructor of the Windows Service by stepping into an instance of the Service. You can debug the Windows Service itself by starting the service and attaching the debugger to the service process. However, to debug the OnStart method of a Windows Service, you must add a few lines of code to simulate the service. For more information, see ServiceBase.OnStart.

To debug a problem in the OnStart method

• Create a simulation of the service (a console application, for instance) to determine where the problem is.

  For example, assume you have a Visual C# Windows Service that looks like this:

  public class ManagedWindowsService : System.ServiceProcess.ServiceBase 
  {
     //
     // designer and user generated methods and properties
     //
     public static int main(String[] args)
     {      
        ServiceBase.Run( new ManagedWindowsService() );
     }
  }
  

  Add the following lines of code to debug the OnStart method:

  public static int main(String[] args)
  {      
     (new ManagedWindowsService()).OnStart(); // allows easy debugging of OnStart()
     ServiceBase.Run( new ManagedWindowsService() );
  }
  

  The Service will not run in this mode, but you can debug the OnStart method and verify that it is behaving as expected.

For more information, see Debugging Windows Service Applications.

See Also

Concepts

Debugger Security

Other Resources

Debugging Managed Code