How To Convert Existing C# Application Into Windows Service

Ashutosh Gupta

10 Comments

Join the conversation! Your thoughts help the community grow.

Pouria Riyahi6y ago
Debug mode work correctly but in service my exe dont run
Ishu Jain6y ago
Is it better to convert console application to windows service or write the new windows service ? Is there any advantage of creating new windows service, in terms of performance of threads.As of now, my console app, has large number of threads in it.
- Ashutosh Gupta6y ago
  Ishu, you don't need to write new service here, you can convert your app to windows service directly. services are independent of no of threads. performance is decided by you algorithm and management of resources in your program. make sure all resources are disposed when service is stopped etc.
Ubaid Khan6y ago
I have an error when i start service i.e. windows could not start service on local computer Error 1064 An exception occurred in the service when handling the control request. Please guide me its urgent
- Ashutosh Gupta6y ago
  This error can happen due to multiple reason, one reason could be your connection string with DB or mismatch .net framework etc. you can debug your service to find out which line throw this exception. you can add logs/events in your programs to find route cause of the error.
Abhay Deshpande7y ago
Nice article, very helpful for beginners..
Mahesh Chand7y ago
Nice. Thank you!
- Ashutosh Gupta7y ago
  Thanks Mahesh, please have a look on my other articles on docker and kubernetes using .net core. and give your feedback to improve it. thanks again..
Sourav Kumar Das7y ago
Good Article Bro.
Rajanikant Hawaldar7y ago
very good, nice article

In this blog, I will be demonstrating the process of converting an existing exe application into a Windows Service using multiple steps - Windows Services creation, launching of the exe in hidden mode when services start, log the information using event log, and also, write the unit tests to test Windows Service.

Let's start with Visual Studio to create one .exe application.

Open VS, go to File > New and select Project. Now, select a new project from the dialog box and create a new .NET Framework console application (for example, Myexe) and add the below logic to test that this exe was called from Windows Service.

static void Main(string[] args)
{
using (var sw = new StreamWriter(args[0]))
{
sw.WriteLine("Welcome to Windows service in .net");
}
Console.Readkey();
}

Now, let's create a Windows Service using Visual Studio. So, go to File > New and select Project as “Window Service”. I am creating this project under the same solution, but you can try with a new solution too.

The next step is to add an installer for this Windows Service. Right-click on the blank area and select "Add installer". This installer registers the service to the control manager.

Open ProjectInstaller.Designer.cs => InitializeComponent() to update the service name, display name and description of the service, as shown below. And set the account as LocalSystem; else, it will prompt for username and password during installation.

private void InitializeComponent()
{
this.serviceProcessInstaller1 = new System.ServiceProcess.ServiceProcessInstaller();
this.serviceInstaller1 = new System.ServiceProcess.ServiceInstaller();
//
// serviceProcessInstaller1
//
this.serviceProcessInstaller1.Password = null;
this.serviceProcessInstaller1.Username = null;
this.serviceProcessInstaller1.Account = System.ServiceProcess.ServiceAccount.LocalSystem;
//
// serviceInstaller1
//
this.serviceInstaller1.ServiceName = "MyWindowservice";
this.serviceInstaller1.Description = "MyWindowservice Description";
this.serviceInstaller1.DisplayName = "MyWindowservice";
this.serviceInstaller1.StartType = System.ServiceProcess.ServiceStartMode.Automatic;
//
// ProjectInstaller
//
this.Installers.AddRange(new System.Configuration.Install.Installer[] {
this.serviceProcessInstaller1,
this.serviceInstaller1});
}

Now, we will implement the real service where we launch the .exe created in step1 when this Windows Service starts.

Open your service class(in my case MyWindowService.Designer.cs) and you should be having two default methods - OnStart & OnStop().
Use event logger to log the Windows Service information.
Go to the InitializeComponent method and initialize the event logger.

/// <summary>
/// Required method for Designer support - do not modify
/// the contents of this method with the code editor.
/// </summary>
private void InitializeComponent()
{
components = new System.ComponentModel.Container();
this.eventLogger = new System.Diagnostics.EventLog();
((System.ComponentModel.ISupportInitialize)(this.eventLogger)).BeginInit();
//
// SystemManagerService
//
this.CanHandleSessionChangeEvent = true;
this.ServiceName = "MyWindowService";
((System.ComponentModel.ISupportInitialize)(this.eventLogger)).EndInit();
}
#endregion
private System.Diagnostics.EventLog eventLogger;

Now, write the implementations of two default methods, i.e., OnStart and OnStop.

OnStart starts a new process to launch the .exe created in step1. The .exe execution must be written into the file to verify that our service is started and the task manager should have an entry for Myexe.
OnStop is used to stop the service which kills the process. Verify in the task manager that the service is stopped.
Use eventLogger.WriteEntry to log any information.

The below code snippet represents the main service class with those two methods.

public partial class MyWindowService : ServiceBase
{
private int processId;
private string filePath;
public MyWindowService()
{
InitializeComponent();
}
public void Verify(string[] args)
{
this.OnStart(args);
// do something here...
this.OnStop();
}
protected override void OnStart(string[] args)
{
var location = new Uri(Assembly.GetEntryAssembly().CodeBase).LocalPath;
var path = Path.GetDirectoryName(location);
var serverPath = Path.Combine(path, "MyExe.exe");
Process cmd = new Process();
cmd.StartInfo.FileName = serverPath;
cmd.StartInfo.WindowStyle = ProcessWindowStyle.Hidden;
using (var f = File.Create(Path.Combine(path, "TestFile.txt")))
{
filePath = f.Name;
}
cmd.StartInfo.Arguments = filePath;
cmd.Start();
processId = cmd.Id;
}
protected override void OnStop()
{
Process process = null;
try
{
process = Process.GetProcessById((int)processId);
}
finally
{
if (process != null)
{
process.Kill();
process.WaitForExit();
process.Dispose();
}
File.Delete(filePath);
}
}
}

Now rebuild your application, I have defined the same Output Directory Pathfor my both projects.

Now its time to Install the Service and verify it.

Run the command prompt in administrator mode and run the below script.

cd C:\Windows\Microsoft.NET\Framework\v4.0.30319

Install/Uninstall Windows Service

We have InstallUtil.exe which comes with installation of ,net framework to install windows service.

Run below command to register service.
InstallUtil.exe OutputDirectoryPath + \your service name + .exe and press enter
Run below command to unregister service whenever you want to remove it.
InstallUtil.exe -u OutputDirectoryPath + \your service name + .exe and press enter

Verify your service by executing command "Services.msc", you should find you service if the installation was successful.

Once the service is started, then I can find my txt file which was executed by Myexe which verifies that service was started.

Once the service is stopped, txt file must be deleted, which verifies that service has been stopped and no process(myexe) is running.

How to test/debug windows service

It is very simple to debug your Windows Service by creating a new Console application and introduce a new public method in your service which calls OnStart and OnStop methods internally.

class Program
{
static void Main(string[] args)
{
var myService = new MyWindowService.MyWindowService();
myService.Verify(args);
}
}

public partial class MyWindowService : ServiceBase
{
public void Verify(string[] args)
{
this.OnStart(args);
// do something here...
this.OnStop();
}
}

Summary

This article demonstrated how to create Windows Services to launch any existing exe/process and installing/uninstalling of services and how to test Windows Service.