C#使用Windows Service的簡(jiǎn)單教程(創(chuàng)建、安裝、卸載、調(diào)試)
前言:Microsoft Windows 服務(wù)能夠創(chuàng)建在它們自己的 Windows 會(huì)話中可長(zhǎng)時(shí)間運(yùn)行的可執(zhí)行應(yīng)用程序。這些服務(wù)可以在計(jì)算機(jī)啟動(dòng)時(shí)自動(dòng)啟動(dòng),可以暫停和重新啟動(dòng)而且不顯示任何用戶界面。這使服務(wù)非常適合在服務(wù)器上使用,或任何時(shí)候,為了不影響在同一臺(tái)計(jì)算機(jī)上工作的其他用戶,需要長(zhǎng)時(shí)間運(yùn)行功能時(shí)使用。還可以在不同于登錄用戶的特定用戶帳戶或默認(rèn)計(jì)算機(jī)帳戶的安全上下文中運(yùn)行服務(wù)。本文就向大家介紹如何運(yùn)用C#來(lái)創(chuàng)建、安裝、卸載、調(diào)試Windows Service程序。
一、創(chuàng)建Windows服務(wù)
1)用VS新建Windows 服務(wù)項(xiàng)目
2)默認(rèn)生成文件包括Program.cs,Service1.cs。重命名Service1.cs為你的服務(wù)名或刪除Service1.cs文件然后創(chuàng)建自己的服務(wù)文件,假設(shè)取服務(wù)名字為MyService。注意:如果是刪除Service1.cs文件然后創(chuàng)建自己的服務(wù)文件,需要將Program.cs文件里的Service1修改為MyService。
MyService.cs屬性窗口中,相關(guān)屬性如下:
Autolog 是否自動(dòng)寫(xiě)入系統(tǒng)的日志文件
CanHandlePowerEvent 服務(wù)時(shí)候接受電源事件
CanPauseAndContinue 服務(wù)是否接受暫?;蚶^續(xù)運(yùn)行的請(qǐng)求
CanShutdown 服務(wù)是否在運(yùn)行它的計(jì)算機(jī)關(guān)閉時(shí)收到通知,以便能夠調(diào)用 OnShutDown 過(guò)程
CanStop 服務(wù)是否接受停止運(yùn)行的請(qǐng)求
ServiceName 服務(wù)名
注意:CanPauseAndContinue和CanShutdown的默認(rèn)值均為False,要想使服務(wù)的OnPause()、OnContinue()、OnShutdown()起作用,需要將CanPauseAndContinue和CanShutdown屬性值設(shè)置為T(mén)rue。
3)雙擊MyService.cs服務(wù)文件,在左側(cè)設(shè)計(jì)模式中,右鍵點(diǎn)擊“添加安裝程序”(或者在MyService.cs的屬性窗口的下方點(diǎn)擊添加“添加安裝程序”;如果看不到“添加安裝程序”的可點(diǎn)鏈接,可以右鍵屬性窗口,點(diǎn)擊“命令(C)”后就會(huì)出來(lái)了。注意:是屬性窗口而不是文件屬性窗口),會(huì)自動(dòng)生成Projectinstaller.cs文件以及兩個(gè)安裝組件,如下:
4)單擊“serviceProcessInstaller1”,在其屬性窗口中設(shè)置Account帳號(hào)方式,建議為L(zhǎng)ocalService(當(dāng)然也可以Account屬性改為 LocalSystem,這樣,不論是以哪個(gè)用戶登錄的系統(tǒng),服務(wù)總會(huì)啟動(dòng))。
5)單擊“serviceInstaller1”,在其屬性窗口設(shè)置屬性:
a)Description 服務(wù)描述,直接顯示到Windows服務(wù)列表中的描述;
b)DisplayName 服務(wù)顯示名稱(chēng),直接顯示到Windows服務(wù)列表中的名稱(chēng);
c)ServiceName 服務(wù)進(jìn)程名稱(chēng),安裝與卸載服務(wù)時(shí)的唯一標(biāo)識(shí)。
具體設(shè)置如上圖所示。
6)創(chuàng)建安裝服務(wù)批處理文件Install.bat,可以創(chuàng)建記事本,然后修改后綴為bat,記事本內(nèi)容如下:
%SystemRoot%\Microsoft.NET\Framework\v4.0.30319\installutil.exeWindowsServiceDemo.exe
Net StartMyService
sc config MyServicestart= auto
pause
注意:記事本另存為時(shí)設(shè)置編碼為ANSI
說(shuō)明:第二行為啟動(dòng)服務(wù),第三行為設(shè)置服務(wù)為自動(dòng)運(yùn)行,這兩行視服務(wù)形式自行選擇。如果需要查看腳本運(yùn)行狀況,在腳本最后一行加入pause。
7)同理創(chuàng)建卸載服務(wù)批處理文件Uninstall.bat,內(nèi)容如下:
%SystemRoot%\Microsoft.NET\Framework\v4.0.30319\installutil.exe /uWindowsServiceDemo.exe
pause
8)將Install.bat以及Uninstall.bat這兩個(gè)文件添加到bin\Debug目錄下,此時(shí)解決方案的目錄結(jié)構(gòu)如下:
9)寫(xiě)服務(wù)代碼,以向文本文件寫(xiě)入文本記錄系統(tǒng)時(shí)間為例:
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("服務(wù)啟動(dòng),時(shí)間:" + DateTime.Now.ToString("HH:mm:ss") + "\r\n"); time.Elapsed += new ElapsedEventHandler(MethodEvent); time.Interval = 60 * 1000;//時(shí)間間隔為2秒鐘 time.Start(); } protected override void OnStop() { #if DEBUG if (!Debugger.IsAttached) Debugger.Launch(); Debugger.Break(); #endif WriteLog("服務(wù)停止,時(shí)間:" + DateTime.Now.ToString("HH:mm:ss") + "\r\n"); } protected override void OnPause() { #if DEBUG if (!Debugger.IsAttached) Debugger.Launch(); Debugger.Break(); #endif WriteLog("服務(wù)暫停,時(shí)間:" + 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("服務(wù)恢復(fù),時(shí)間:" + DateTime.Now.ToString("HH:mm:ss") + "\r\n"); base.OnContinue(); } protected override void OnShutdown() { WriteLog("計(jì)算機(jī)關(guān)閉,時(shí)間:" + 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í)行成功,時(shí)間:" + 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 { } } } }
注意:代碼編寫(xiě)完成后,你無(wú)法點(diǎn)擊通過(guò)啟動(dòng)按鈕或按F5來(lái)運(yùn)行或調(diào)試服務(wù),會(huì)彈出如下圖所示的警告:
二、安裝windows服務(wù)
項(xiàng)目生成成功后,定位到bin\Debug目錄,以管理員身份運(yùn)行Install.bat安裝服務(wù),成功結(jié)果如下圖:
這時(shí),“我的電腦”右鍵,選擇“管理”,選擇“服務(wù)和應(yīng)用程序”下的“服務(wù)”,就可以看到服務(wù)已安裝,如下圖:
同時(shí),Debug文件夾里有了Logs文件夾,Logs文件夾里有txt文檔,內(nèi)容如下:
可以看到,每分鐘執(zhí)行一次。
三、調(diào)試windows服務(wù)
1)通常的處理辦法是,在service運(yùn)行后, 在調(diào)試器中選擇“附加到進(jìn)程”,附加自己的服務(wù)即可調(diào)試。但此法有局限性,例如在service啟動(dòng)時(shí)的OnStart事件中的代碼, 基本上很難調(diào)試,往往當(dāng)attach到我們的service的時(shí)候,這部分代碼已經(jīng)執(zhí)行過(guò)了。當(dāng)然了,你可以讓OnStart事件之前先睡個(gè)20s,趁著服務(wù)睡覺(jué)的時(shí)候趕緊“附加到進(jìn)程”。System.Threading.Thread.Sleep(1000 * 20);
2)我的做法是,在OnStart事件的最開(kāi)始部分加上“Debugger.Launch();”的調(diào)用, 當(dāng)service運(yùn)行到此處時(shí),將會(huì)彈出一個(gè)選擇調(diào)試器的對(duì)話框,同時(shí)暫停在當(dāng)前位置。這樣,我們就做到了在代碼中手動(dòng)的啟動(dòng)調(diào)試器。
說(shuō)明:a)Debugger.Launch()方法的作用是“啟動(dòng)調(diào)試器并將其連接到進(jìn)程”;
b)可以手動(dòng)設(shè)置斷點(diǎn),也可以用“Debugger.Break();”動(dòng)態(tài)設(shè)置斷點(diǎn);
c)為了避免多個(gè)調(diào)試器實(shí)例,可以用“Debugger.IsAttached”屬性判斷調(diào)試器是否已附加到進(jìn)程,代碼片段:
if (!Debugger.IsAttached) Debugger.Launch();
d)為了使調(diào)試只在Debug模式下生效,Release模式下無(wú)效,可以用條件編譯來(lái)處理,代碼片段如下:
#if DEBUG if (!Debugger.IsAttached) Debugger.Launch(); Debugger.Break(); #endif
關(guān)于條件編譯,請(qǐng)查看我的另一篇博客:C#-#define條件編譯
e)在調(diào)試服務(wù)的其他事件或方法時(shí),同樣可以用到。
彈出選擇調(diào)試器的對(duì)話框,以及調(diào)試界面如下圖所示:
四、卸載windows服務(wù)
卸載服務(wù),同樣以管理員身份運(yùn)行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
以上就是本文的全部?jī)?nèi)容,希望對(duì)大家的學(xué)習(xí)有所幫助,也希望大家多多支持腳本之家。
- VSCode調(diào)試C#程序及附缺失.dll文件的解決辦法
- C#客戶端程序Visual Studio遠(yuǎn)程調(diào)試的方法詳解
- C#動(dòng)態(tài)加載組件后如何在開(kāi)發(fā)環(huán)境中調(diào)試詳解
- C#中利用斷點(diǎn)操作調(diào)試程序的步驟詳解
- C# Web應(yīng)用調(diào)試開(kāi)啟外部訪問(wèn)步驟解析
- C#中一些你可能沒(méi)用過(guò)的調(diào)試窗口的方法
- C# 動(dòng)態(tài)編譯、動(dòng)態(tài)執(zhí)行、動(dòng)態(tài)調(diào)試
- c# 代碼調(diào)試技巧和如何遠(yuǎn)程調(diào)試
相關(guān)文章
c#實(shí)現(xiàn)ini文件讀寫(xiě)類(lèi)分享
c#實(shí)現(xiàn)ini文件讀寫(xiě)類(lèi)分享,大家參考使用吧2013-12-12C# PC版微信消息監(jiān)聽(tīng)自動(dòng)回復(fù)的實(shí)現(xiàn)方法
這篇文章主要介紹了C# PC版微信消息監(jiān)聽(tīng)自動(dòng)回復(fù)的實(shí)現(xiàn)方法,文中通過(guò)示例代碼介紹的非常詳細(xì),對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友們下面隨著小編來(lái)一起學(xué)習(xí)學(xué)習(xí)吧2020-05-05基于Unity制作一個(gè)簡(jiǎn)易的計(jì)算器
今天主要和大家分享如何使用Unity制作計(jì)算器,難度中等,可以用來(lái)學(xué)習(xí),或者當(dāng)成其他項(xiàng)目的小組件導(dǎo)入。當(dāng)然,也可以導(dǎo)出來(lái),發(fā)布到網(wǎng)頁(yè)端,來(lái)做一個(gè)嵌入式工具也可以。感興趣的可以跟隨小編學(xué)習(xí)一下2022-03-03C#生成設(shè)置范圍內(nèi)的Double類(lèi)型隨機(jī)數(shù)的方法
這篇文章主要介紹了C#生成設(shè)置范圍內(nèi)的Double類(lèi)型隨機(jī)數(shù)的方法,對(duì)于C#的初學(xué)者有很好的借鑒價(jià)值,需要的朋友可以參考下2014-08-08C# 無(wú)邊框窗體邊框陰影效果的簡(jiǎn)單實(shí)現(xiàn)
這篇文章介紹了C# 無(wú)邊框窗體邊框陰影效果的簡(jiǎn)單實(shí)現(xiàn),有需要的朋友可以參考一下2013-10-10C#實(shí)現(xiàn)強(qiáng)制關(guān)閉當(dāng)前程序進(jìn)程
這篇文章主要介紹了C#實(shí)現(xiàn)強(qiáng)制關(guān)閉當(dāng)前程序進(jìn)程,本文直接給出實(shí)現(xiàn)代碼,可以實(shí)現(xiàn)完全Kill掉不留痕跡,需要的朋友可以參考下2015-06-06