C#使用Windows Service的簡單教程(創(chuàng)建、安裝、卸載、調(diào)試)
前言:Microsoft Windows 服務能夠創(chuàng)建在它們自己的 Windows 會話中可長時間運行的可執(zhí)行應用程序。這些服務可以在計算機啟動時自動啟動,可以暫停和重新啟動而且不顯示任何用戶界面。這使服務非常適合在服務器上使用,或任何時候,為了不影響在同一臺計算機上工作的其他用戶,需要長時間運行功能時使用。還可以在不同于登錄用戶的特定用戶帳戶或默認計算機帳戶的安全上下文中運行服務。本文就向大家介紹如何運用C#來創(chuàng)建、安裝、卸載、調(diào)試Windows Service程序。
一、創(chuàng)建Windows服務
1)用VS新建Windows 服務項目

2)默認生成文件包括Program.cs,Service1.cs。重命名Service1.cs為你的服務名或刪除Service1.cs文件然后創(chuàng)建自己的服務文件,假設取服務名字為MyService。注意:如果是刪除Service1.cs文件然后創(chuàng)建自己的服務文件,需要將Program.cs文件里的Service1修改為MyService。
MyService.cs屬性窗口中,相關屬性如下:
Autolog 是否自動寫入系統(tǒng)的日志文件
CanHandlePowerEvent 服務時候接受電源事件
CanPauseAndContinue 服務是否接受暫停或繼續(xù)運行的請求
CanShutdown 服務是否在運行它的計算機關閉時收到通知,以便能夠調(diào)用 OnShutDown 過程
CanStop 服務是否接受停止運行的請求
ServiceName 服務名
注意:CanPauseAndContinue和CanShutdown的默認值均為False,要想使服務的OnPause()、OnContinue()、OnShutdown()起作用,需要將CanPauseAndContinue和CanShutdown屬性值設置為True。
3)雙擊MyService.cs服務文件,在左側(cè)設計模式中,右鍵點擊“添加安裝程序”(或者在MyService.cs的屬性窗口的下方點擊添加“添加安裝程序”;如果看不到“添加安裝程序”的可點鏈接,可以右鍵屬性窗口,點擊“命令(C)”后就會出來了。注意:是屬性窗口而不是文件屬性窗口),會自動生成Projectinstaller.cs文件以及兩個安裝組件,如下:

4)單擊“serviceProcessInstaller1”,在其屬性窗口中設置Account帳號方式,建議為LocalService(當然也可以Account屬性改為 LocalSystem,這樣,不論是以哪個用戶登錄的系統(tǒng),服務總會啟動)。
5)單擊“serviceInstaller1”,在其屬性窗口設置屬性:
a)Description 服務描述,直接顯示到Windows服務列表中的描述;
b)DisplayName 服務顯示名稱,直接顯示到Windows服務列表中的名稱;
c)ServiceName 服務進程名稱,安裝與卸載服務時的唯一標識。
具體設置如上圖所示。
6)創(chuàng)建安裝服務批處理文件Install.bat,可以創(chuàng)建記事本,然后修改后綴為bat,記事本內(nèi)容如下:
%SystemRoot%\Microsoft.NET\Framework\v4.0.30319\installutil.exeWindowsServiceDemo.exe
Net StartMyService
sc config MyServicestart= auto
pause
注意:記事本另存為時設置編碼為ANSI
說明:第二行為啟動服務,第三行為設置服務為自動運行,這兩行視服務形式自行選擇。如果需要查看腳本運行狀況,在腳本最后一行加入pause。
7)同理創(chuàng)建卸載服務批處理文件Uninstall.bat,內(nèi)容如下:
%SystemRoot%\Microsoft.NET\Framework\v4.0.30319\installutil.exe /uWindowsServiceDemo.exe
pause
8)將Install.bat以及Uninstall.bat這兩個文件添加到bin\Debug目錄下,此時解決方案的目錄結(jié)構(gòu)如下:

9)寫服務代碼,以向文本文件寫入文本記錄系統(tǒng)時間為例:
using System;
using System.IO;
using System.Diagnostics;
using System.ServiceProcess;
using System.Timers;
namespace WindowsServiceDemo
{
public partial class MyService : ServiceBase
{
private Timer time = new Timer();
public MyService()
{
InitializeComponent();
}
protected override void OnStart(string[] args)
{
#if DEBUG
if (!Debugger.IsAttached)
Debugger.Launch();
Debugger.Break();
#endif
WriteLog("服務啟動,時間:" + DateTime.Now.ToString("HH:mm:ss") + "\r\n");
time.Elapsed += new ElapsedEventHandler(MethodEvent);
time.Interval = 60 * 1000;//時間間隔為2秒鐘
time.Start();
}
protected override void OnStop()
{
#if DEBUG
if (!Debugger.IsAttached)
Debugger.Launch();
Debugger.Break();
#endif
WriteLog("服務停止,時間:" + DateTime.Now.ToString("HH:mm:ss") + "\r\n");
}
protected override void OnPause()
{
#if DEBUG
if (!Debugger.IsAttached)
Debugger.Launch();
Debugger.Break();
#endif
WriteLog("服務暫停,時間:" + DateTime.Now.ToString("HH:mm:ss") + "\r\n");
base.OnPause();
}
protected override void OnContinue()
{
#if DEBUG
if (!Debugger.IsAttached)
Debugger.Launch();
Debugger.Break();
#endif
WriteLog("服務恢復,時間:" + DateTime.Now.ToString("HH:mm:ss") + "\r\n");
base.OnContinue();
}
protected override void OnShutdown()
{
WriteLog("計算機關閉,時間:" + DateTime.Now.ToString("HH:mm:ss") + "\r\n");
base.OnShutdown();
}
private void MethodEvent(object source, System.Timers.ElapsedEventArgs e)
{
time.Enabled = false;
string result = string.Empty;
try
{
//.........
result = "執(zhí)行成功,時間:" + DateTime.Now.ToString("HH:mm:ss") + "\r\n";
}
catch (Exception ex)
{
result = "執(zhí)行失敗,原因:" + ex.Message + "\r\n";
}
finally
{
WriteLog(result);
time.Enabled = true;
}
}
/// <summary>
/// 日志記錄
/// </summary>
/// <param name="logInfo"></param>
private void WriteLog(string logInfo)
{
try
{
string logDirectory = AppDomain.CurrentDomain.BaseDirectory + "\\Logs";
if (!Directory.Exists(logDirectory))
{
Directory.CreateDirectory(logDirectory);
}
string filePath = logDirectory + "\\" + DateTime.Now.ToString("yyyy-MM-dd") + ".txt";
File.AppendAllText(filePath, logInfo);
}
catch
{
}
}
}
}
注意:代碼編寫完成后,你無法點擊通過啟動按鈕或按F5來運行或調(diào)試服務,會彈出如下圖所示的警告:

二、安裝windows服務
項目生成成功后,定位到bin\Debug目錄,以管理員身份運行Install.bat安裝服務,成功結(jié)果如下圖:

這時,“我的電腦”右鍵,選擇“管理”,選擇“服務和應用程序”下的“服務”,就可以看到服務已安裝,如下圖:

同時,Debug文件夾里有了Logs文件夾,Logs文件夾里有txt文檔,內(nèi)容如下:

可以看到,每分鐘執(zhí)行一次。
三、調(diào)試windows服務
1)通常的處理辦法是,在service運行后, 在調(diào)試器中選擇“附加到進程”,附加自己的服務即可調(diào)試。但此法有局限性,例如在service啟動時的OnStart事件中的代碼, 基本上很難調(diào)試,往往當attach到我們的service的時候,這部分代碼已經(jīng)執(zhí)行過了。當然了,你可以讓OnStart事件之前先睡個20s,趁著服務睡覺的時候趕緊“附加到進程”。System.Threading.Thread.Sleep(1000 * 20);
2)我的做法是,在OnStart事件的最開始部分加上“Debugger.Launch();”的調(diào)用, 當service運行到此處時,將會彈出一個選擇調(diào)試器的對話框,同時暫停在當前位置。這樣,我們就做到了在代碼中手動的啟動調(diào)試器。
說明:a)Debugger.Launch()方法的作用是“啟動調(diào)試器并將其連接到進程”;
b)可以手動設置斷點,也可以用“Debugger.Break();”動態(tài)設置斷點;
c)為了避免多個調(diào)試器實例,可以用“Debugger.IsAttached”屬性判斷調(diào)試器是否已附加到進程,代碼片段:
if (!Debugger.IsAttached) Debugger.Launch();
d)為了使調(diào)試只在Debug模式下生效,Release模式下無效,可以用條件編譯來處理,代碼片段如下:
#if DEBUG if (!Debugger.IsAttached) Debugger.Launch(); Debugger.Break(); #endif
關于條件編譯,請查看我的另一篇博客:C#-#define條件編譯
e)在調(diào)試服務的其他事件或方法時,同樣可以用到。
彈出選擇調(diào)試器的對話框,以及調(diào)試界面如下圖所示:


四、卸載windows服務
卸載服務,同樣以管理員身份運行Uninstall.bat即可,成功結(jié)果如下圖:

參考鏈接:https://msdn.microsoft.com/zh-cn/library/windows/desktop/system.diagnostics.debugger(v=vs.110).aspx
源碼下載:http://xiazai.jb51.net/201701/yuanma/WindowsService(jb51.net).rar
以上就是本文的全部內(nèi)容,希望對大家的學習有所幫助,也希望大家多多支持腳本之家。
相關文章
C# PC版微信消息監(jiān)聽自動回復的實現(xiàn)方法
這篇文章主要介紹了C# PC版微信消息監(jiān)聽自動回復的實現(xiàn)方法,文中通過示例代碼介紹的非常詳細,對大家的學習或者工作具有一定的參考學習價值,需要的朋友們下面隨著小編來一起學習學習吧2020-05-05
C#生成設置范圍內(nèi)的Double類型隨機數(shù)的方法
這篇文章主要介紹了C#生成設置范圍內(nèi)的Double類型隨機數(shù)的方法,對于C#的初學者有很好的借鑒價值,需要的朋友可以參考下2014-08-08

