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

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 是否自動寫入系統(tǒng)的日志文件
CanHandlePowerEvent 服務(wù)時候接受電源事件
CanPauseAndContinue 服務(wù)是否接受暫停或繼續(xù)運(yùn)行的請求
CanShutdown 服務(wù)是否在運(yùn)行它的計算機(jī)關(guān)閉時收到通知,以便能夠調(diào)用 OnShutDown 過程
CanStop 服務(wù)是否接受停止運(yùn)行的請求
ServiceName 服務(wù)名
注意:CanPauseAndContinue和CanShutdown的默認(rèn)值均為False,要想使服務(wù)的OnPause()、OnContinue()、OnShutdown()起作用,需要將CanPauseAndContinue和CanShutdown屬性值設(shè)置為True。
3)雙擊MyService.cs服務(wù)文件,在左側(cè)設(shè)計模式中,右鍵點擊“添加安裝程序”(或者在MyService.cs的屬性窗口的下方點擊添加“添加安裝程序”;如果看不到“添加安裝程序”的可點鏈接,可以右鍵屬性窗口,點擊“命令(C)”后就會出來了。注意:是屬性窗口而不是文件屬性窗口),會自動生成Projectinstaller.cs文件以及兩個安裝組件,如下:

4)單擊“serviceProcessInstaller1”,在其屬性窗口中設(shè)置Account帳號方式,建議為LocalService(當(dāng)然也可以Account屬性改為 LocalSystem,這樣,不論是以哪個用戶登錄的系統(tǒng),服務(wù)總會啟動)。
5)單擊“serviceInstaller1”,在其屬性窗口設(shè)置屬性:
a)Description 服務(wù)描述,直接顯示到Windows服務(wù)列表中的描述;
b)DisplayName 服務(wù)顯示名稱,直接顯示到Windows服務(wù)列表中的名稱;
c)ServiceName 服務(wù)進(jìn)程名稱,安裝與卸載服務(wù)時的唯一標(biāo)識。
具體設(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è)置編碼為ANSI
說明:第二行為啟動服務(wù),第三行為設(shè)置服務(wù)為自動運(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這兩個文件添加到bin\Debug目錄下,此時解決方案的目錄結(jié)構(gòu)如下:

9)寫服務(wù)代碼,以向文本文件寫入文本記錄系統(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("服務(wù)啟動,時間:" + 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("服務(wù)停止,時間:" + DateTime.Now.ToString("HH:mm:ss") + "\r\n");
}
protected override void OnPause()
{
#if DEBUG
if (!Debugger.IsAttached)
Debugger.Launch();
Debugger.Break();
#endif
WriteLog("服務(wù)暫停,時間:" + 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ù),時間:" + DateTime.Now.ToString("HH:mm:ss") + "\r\n");
base.OnContinue();
}
protected override void OnShutdown()
{
WriteLog("計算機(jī)關(guān)閉,時間:" + 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來運(yùn)行或調(diào)試服務(wù),會彈出如下圖所示的警告:

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

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

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

可以看到,每分鐘執(zhí)行一次。
三、調(diào)試windows服務(wù)
1)通常的處理辦法是,在service運(yùn)行后, 在調(diào)試器中選擇“附加到進(jìn)程”,附加自己的服務(wù)即可調(diào)試。但此法有局限性,例如在service啟動時的OnStart事件中的代碼, 基本上很難調(diào)試,往往當(dāng)attach到我們的service的時候,這部分代碼已經(jīng)執(zhí)行過了。當(dāng)然了,你可以讓OnStart事件之前先睡個20s,趁著服務(wù)睡覺的時候趕緊“附加到進(jìn)程”。System.Threading.Thread.Sleep(1000 * 20);
2)我的做法是,在OnStart事件的最開始部分加上“Debugger.Launch();”的調(diào)用, 當(dāng)service運(yùn)行到此處時,將會彈出一個選擇調(diào)試器的對話框,同時暫停在當(dāng)前位置。這樣,我們就做到了在代碼中手動的啟動調(diào)試器。
說明:a)Debugger.Launch()方法的作用是“啟動調(diào)試器并將其連接到進(jìn)程”;
b)可以手動設(shè)置斷點,也可以用“Debugger.Break();”動態(tài)設(shè)置斷點;
c)為了避免多個調(diào)試器實例,可以用“Debugger.IsAttached”屬性判斷調(diào)試器是否已附加到進(jìn)程,代碼片段:
if (!Debugger.IsAttached) Debugger.Launch();
d)為了使調(diào)試只在Debug模式下生效,Release模式下無效,可以用條件編譯來處理,代碼片段如下:
#if DEBUG if (!Debugger.IsAttached) Debugger.Launch(); Debugger.Break(); #endif
關(guān)于條件編譯,請查看我的另一篇博客:C#-#define條件編譯
e)在調(diào)試服務(wù)的其他事件或方法時,同樣可以用到。
彈出選擇調(diào)試器的對話框,以及調(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
以上就是本文的全部內(nèi)容,希望對大家的學(xué)習(xí)有所幫助,也希望大家多多支持腳本之家。
相關(guān)文章
C#如何實現(xiàn)監(jiān)控手機(jī)屏幕(附源碼下載)
這篇文章主要介紹了C#如何實現(xiàn)監(jiān)控手機(jī)屏幕(附源碼下載),文中通過示例代碼介紹的非常詳細(xì),對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價值,需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧2020-10-10
C#編程中使用ref和out關(guān)鍵字來傳遞數(shù)組對象的用法
這篇文章主要介紹了C#編程中使用ref和out關(guān)鍵字來傳遞數(shù)組對象的用法,在C#中數(shù)組也是對象可以被傳遞,需要的朋友可以參考下2016-01-01
C#中String和StringBuilder的簡介與區(qū)別
今天小編就為大家分享一篇關(guān)于C#中String和StringBuilder的簡介與區(qū)別,小編覺得內(nèi)容挺不錯的,現(xiàn)在分享給大家,具有很好的參考價值,需要的朋友一起跟隨小編來看看吧2018-10-10
C#中DataSet,DataTable,DataView的區(qū)別與用法
這篇文章介紹了C#中DataSet,DataTable,DataView的區(qū)別與用法,文中通過示例代碼介紹的非常詳細(xì)。對大家的學(xué)習(xí)或工作具有一定的參考借鑒價值,需要的朋友可以參考下2022-05-05

