C#創建Windows Service(Windows 服務)基礎教程

C#創建Windows Service(Windows 服務)基礎教程

Windows Service這一塊並不複雜,但是注意事項太多了,網上資料也很凌亂,偶爾自己寫也會丟三落四的。所以本文也就產生了,本文不會寫複雜的東西,完全以基礎應用的需求來寫,所以不會對Windows Service寫很深入。

本文介紹瞭如何用C#創建、安裝、啓動、監控、卸載簡單的Windows Service 的內容步驟和注意事項。

一、創建一個Windows Service

1)創建Windows Service項目

imageimage

2)對Service重命名

將Service1重命名爲你服務名稱,這裏我們命名爲ServiceTest。

二、創建服務安裝程序

1)添加安裝程序

image

image

之後我們可以看到上圖,自動爲我們創建了ProjectInstaller.cs以及2個安裝的組件。

2)修改安裝服務名

右鍵serviceInsraller1,選擇屬性,將ServiceName的值改爲ServiceTest。

image

3)修改安裝權限

右鍵serviceProcessInsraller1,選擇屬性,將Account的值改爲LocalSystem。

image

三、寫入服務代碼

1)打開ServiceTest代碼

右鍵ServiceTest,選擇查看代碼。

2)寫入Service邏輯

添加如下代碼:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Diagnostics;
using System.Linq;
using System.ServiceProcess;
using System.Text;
 
namespace WindowsServiceTest
{
    public partial class ServiceTest : ServiceBase
    {
        public ServiceTest()
        {
            InitializeComponent();
        }
 
        protected override void OnStart(string[] args)
        {
            using (System.IO.StreamWriter sw = new System.IO.StreamWriter("C:\\log.txt", true))
            {
                sw.WriteLine(DateTime.Now.ToString("yyyy-MM-dd HH:mm:ss ") + "Start.");
            }
        }
 
        protected override void OnStop()
        {
            using (System.IO.StreamWriter sw = new System.IO.StreamWriter("C:\\log.txt", true))
            {
                sw.WriteLine(DateTime.Now.ToString("yyyy-MM-dd HH:mm:ss ") + "Stop.");
            }
        }
    }
}

這裏我們的邏輯很簡單,啓動服務的時候寫個日誌,關閉的時候再寫個日誌。

四、創建安裝腳本

在項目中添加2個文件如下(必須是ANSI或者UTF-8無BOM格式):

1)安裝腳本Install.bat

1
2
3
%SystemRoot%\Microsoft.NET\Framework\v4.0.30319\installutil.exe WindowsServiceTest.exe
Net Start ServiceTest
sc config ServiceTest start= auto

2)卸載腳本Uninstall.bat

1
%SystemRoot%\Microsoft.NET\Framework\v4.0.30319\installutil.exe /u WindowsServiceTest.exe

3)安裝腳本說明

第二行爲啓動服務。

第三行爲設置服務爲自動運行。

這2行視服務形式自行選擇。

4)腳本調試

如果需要查看腳本運行狀況,在腳本最後一行加入pause

五、在C#中對服務進行控制

0)配置目錄結構

簡歷一個新WPF項目,叫WindowsServiceTestUI,添加對System.ServiceProcess的引用。

在WindowsServiceTestUI的bin\Debug目錄下建立Service目錄。

將WindowsServiceTest的生成目錄設置爲上面創建的Service目錄。

生成後目錄結構如下圖

image

 

1)安裝

安裝時會產生目錄問題,所以安裝代碼如下:

1
2
3
4
5
6
7
8
string CurrentDirectory = System.Environment.CurrentDirectory;
System.Environment.CurrentDirectory = CurrentDirectory + "\\Service";
Process process = new Process();
process.StartInfo.UseShellExecute = false;
process.StartInfo.FileName = "Install.bat";
process.StartInfo.CreateNoWindow = true;
process.Start();
System.Environment.CurrentDirectory = CurrentDirectory;

2)卸載

卸載時也會產生目錄問題,所以卸載代碼如下:

1
2
3
4
5
6
7
8
string CurrentDirectory = System.Environment.CurrentDirectory;
System.Environment.CurrentDirectory = CurrentDirectory + "\\Service";
Process process = new Process();
process.StartInfo.UseShellExecute = false;
process.StartInfo.FileName = "Uninstall.bat";
process.StartInfo.CreateNoWindow = true;
process.Start();
System.Environment.CurrentDirectory = CurrentDirectory;

3)啓動

代碼如下:

1
2
3
4
5
using System.ServiceProcess;
 
 
ServiceController serviceController = new ServiceController("ServiceTest");
serviceController.Start();

4)停止

1
2
3
ServiceController serviceController = new ServiceController("ServiceTest");
if (serviceController.CanStop)
    serviceController.Stop();

5)暫停/繼續

1
2
3
4
5
6
7
8
ServiceController serviceController = new ServiceController("ServiceTest");
if (serviceController.CanPauseAndContinue)
{
    if (serviceController.Status == ServiceControllerStatus.Running)
        serviceController.Pause();
    else if (serviceController.Status == ServiceControllerStatus.Paused)
        serviceController.Continue();
}

6)檢查狀態

1
2
ServiceController serviceController = new ServiceController("ServiceTest");
string Status = serviceController.Status.ToString();

六、調試Windows Service

1)安裝並運行服務

2)附加進程

imageimage

3)在代碼中加入斷點進行調試

image

七、總結

本文對Windows service的上述配置都未做詳細解釋,但是按上述步驟就可以製作可運行的Windows Service,從而達到了工作的需求。

示例代碼請見:https://github.com/sorex/WindowsServiceTest

發佈了5 篇原創文章 · 獲贊 8 · 訪問量 8萬+
發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章