C#創建Windows Service(Windows 服務)基礎教程
Windows Service這一塊並不複雜,但是注意事項太多了,網上資料也很凌亂,偶爾自己寫也會丟三落四的。所以本文也就產生了,本文不會寫複雜的東西,完全以基礎應用的需求來寫,所以不會對Windows Service寫很深入。
本文介紹瞭如何用C#創建、安裝、啓動、監控、卸載簡單的Windows Service 的內容步驟和注意事項。
一、創建一個Windows Service
1)創建Windows Service項目
2)對Service重命名
將Service1重命名爲你服務名稱,這裏我們命名爲ServiceTest。
二、創建服務安裝程序
1)添加安裝程序
之後我們可以看到上圖,自動爲我們創建了ProjectInstaller.cs以及2個安裝的組件。
2)修改安裝服務名
右鍵serviceInsraller1,選擇屬性,將ServiceName的值改爲ServiceTest。
3)修改安裝權限
右鍵serviceProcessInsraller1,選擇屬性,將Account的值改爲LocalSystem。
三、寫入服務代碼
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目錄。
生成後目錄結構如下圖
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)附加進程
3)在代碼中加入斷點進行調試
七、總結
本文對Windows service的上述配置都未做詳細解釋,但是按上述步驟就可以製作可運行的Windows Service,從而達到了工作的需求。