How To Create Windows Services In C#

In this tutorial, I explain how to create a Windows Service in C#. We will also learn how to configure a Windows Service in .NET and how to create a Windows Service in .NET using Visual Studio.

What is a Windows Service?

Windows Services are non UI software applications that run in the background. Windows services are usually started when an operating system boots and scheduled to run in the background to execute some tasks. Windows services can also be started automatically or manually. You can also manually pause, stop and restart Windows services.

Windows service is a computer program that runs in the background to execute some tasks. Some examples of Windows services are an auto update of Windows, check emails, print documents, SQL Server agent, file and folder scanning and indexing and so on. If you open your Task Manager and click on the Services tab, you will see hundreds of services running on your machine. You can also see the statuses of these services. Some services are running, some have paused, and some have stopped. You can start, stop, and pause a service from here by right click on the service.

We may also find all the services running on our machine in the following ways:

  • Go to Control Panel select “Services” inside “Administrative Tools”.
  • Open Run window (Window + R) and type services.msc and press ENTER.

create-windows-service-2

How to create a Windows service in C#

Let’s create a Windows Service in C# using Visual Studio.

Step 1

Open Visual Studio, go to File > New and select Project. Now select a new project from the Dialog box and select “Window Service” and click on OK button.

Step 2

Go to Visual C# -> ”Windows Desktop” -> ”Windows Service” and give an appropriate name and then click OK

Once you click on OK button the below screen will appear, which is your service

Step 3

Right click on the blank area and select “Add Installer”

How to Add an Installer to a Windows Service

Before you can run a Windows Service, you need to install the Installer, which registers it with the Service Control Manager.

After Adding Installer, ProjectInstaller will add in your project and ProjectInstakker.cs file will be open. Don’t forget to save everything (by pressing Ctrl + shift + s key)

Solution Explorer looks like this:

Step 4

Right click on a blank area and select “View Code”

Step 5


Its has Constructor which contains the InitializeComponent method:
The InitializeComponent method contains the logic which creates and initializes the user interface objects dragged on the forming surface and provided the Property Grid of Form Designer.

Very important: Don’t ever try to call any method before the call of the InitializeComponent method.

Step 6

Select the InitializeComponent method and press F12 key to go definition

Step 7

Now add the below line:

this.serviceProcessInstaller1.Account = System.ServiceProcess.ServiceAccount.LocalSystem;
You also can add a description and display service name (optionally).
this.serviceInstaller1.Description = "My First Service demo";  
this.serviceInstaller1.DisplayName = "MyFirstService.Demo";

Step 8

In this step, we will implement a timer, and code to call the service at a given time. We will create a text file and write the current time in the text file using the service.

 

Service1.cs class 

using System;  
using System.Collections.Generic;  
using System.ComponentModel;  
using System.Data;  
using System.Diagnostics;  
using System.IO;  
using System.Linq;  
using System.ServiceProcess;  
using System.Text;  
using System.Threading.Tasks;  
using System.Timers;  
namespace MyFirstService {  
    public partial class Service1: ServiceBase {  
        Timer timer = new Timer(); // name space(using System.Timers;)  
        public Service1() {  
            InitializeComponent();  
        }  
        protected override void OnStart(string[] args) {  
            WriteToFile("Service is started at " + DateTime.Now);  
            timer.Elapsed += new ElapsedEventHandler(OnElapsedTime);  
            timer.Interval = 5000; //number in milisecinds  
            timer.Enabled = true;  
        }  
        protected override void OnStop() {  
            WriteToFile("Service is stopped at " + DateTime.Now);  
        }  
        private void OnElapsedTime(object source, ElapsedEventArgs e) {  
            WriteToFile("Service is recall at " + DateTime.Now);  
        }  
        public void WriteToFile(string Message) {  
            string path = AppDomain.CurrentDomain.BaseDirectory + "\\Logs";  
            if (!Directory.Exists(path)) {  
                Directory.CreateDirectory(path);  
            }  
            string filepath = AppDomain.CurrentDomain.BaseDirectory + "\\Logs\\ServiceLog_" + DateTime.Now.Date.ToShortDateString().Replace('/', '_') + ".txt";  
            if (!File.Exists(filepath)) {  
                // Create a file to write to.   
                using(StreamWriter sw = File.CreateText(filepath)) {  
                    sw.WriteLine(Message);  
                }  
            } else {  
                using(StreamWriter sw = File.AppendText(filepath)) {  
                    sw.WriteLine(Message);  
                }  
            }  
        }  
    }  
}
Code explanation – the above code will call service every 5 seconds and create a folder if none exists and write our message.

Step 9. Rebuild your application.

Right click on your project or solution and select Rebuild.

Step 10

Search “Command Prompt” and run as administrator

Step 11

Fire the below command in the command prompt and press ENTER.

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

Step 12

Now Go to your project source folder > bin > Debug and copy the full path of your Windows Service exe file.

Installing a Windows Service

Open a command prompt and fire the below command and press ENTER.

Syntax

InstallUtil.exe + Your copied path + \your service name + .exe

Our path

InstallUtil.exe C:\Users\Faisal-Pathan\source\repos\MyFirstService\MyFirstService\bin\Debug\MyFirstService.exe

Check the status of a Windows Service

Open services by following the below steps:
  1. Press Window key + R.
  2. Type services.msc
  3. Find your Service.

You may notice that the Windows service is running.

 

Check Windows Service Output

The service will create a text file with the following text in it.
Log folder will be created in your bin folder.

Uninstalling a Windows Service

If you want to uninstall your service, fire the below command.

  1. Syntax InstallUtil.exe -u + Your copied path + \your service name + .exe
  2. Our path InstallUtil.exe -u C:\Users\Faisal-Pathan\source\repos\MyFirstService\MyFirstService\bin\Debug\MyFirstService.exe

Summary

In this article, we learned how to create a Windows Service and install/Uninstall it using InstallUtil.exe from the command prompt.

I hope, you found this tutorial easy to follow and understand.

I also uploaded this project on GitHub, here is the link.

2 Comments

  1. Shaikh Irshad

    Good article and easy to understand for beginners

    0
    0
    Reply

Submit a Comment

Your email address will not be published. Required fields are marked *

Subscribe

Select Categories