用.NET創(chuàng)建Windows服務(wù)
譯者說明：我是通過翻譯來學(xué)習(xí)C＃的，文中涉及到的有Visual Studio.NET有關(guān)操作，我都根據(jù)中文版的VS.NET顯示信息來處理的，可以讓大家不致有誤解。
作者：Mark Strawmyer
我們將研究如何創(chuàng)建一個作為Windows服務(wù)的應(yīng)用程序。內(nèi)容包含什么是Windows服務(wù)，如何創(chuàng)建、安裝和調(diào)試它們。會用到System.ServiceProcess.ServiceBase命名空間的類。
什么是Windows服務(wù)？
Windows服務(wù)應(yīng)用程序是一種需要長期運(yùn)行的應(yīng)用程序，它對于服務(wù)器環(huán)境特別適合。它沒有用戶界面，并且也不會產(chǎn)生任何可視輸出。任何用戶消息都會被寫進(jìn)Windows事件日志。計算機(jī)啟動時，服務(wù)會自動開始運(yùn)行。它們不要用戶一定登錄才運(yùn)行，它們能在包括這個系統(tǒng)內(nèi)的任何用戶環(huán)境下運(yùn)行。通過服務(wù)控制管理器，Windows服務(wù)是可控的，可以終止、暫停及當(dāng)需要時啟動。
Windows 服務(wù)，以前的NT服務(wù)，都是被作為Windows NT操作系統(tǒng)的一部分引進(jìn)來的。它們在Windows 9x及Windows Me下沒有。你需要使用NT級別的操作系統(tǒng)來運(yùn)行Windows服務(wù)，諸如：Windows NT、Windows 2000 Professional或Windows 2000 Server。舉例而言，以Windows服務(wù)形式的產(chǎn)品有：Microsoft Exchange、SQL Server，還有別的如設(shè)置計算機(jī)時鐘的Windows Time服務(wù)。
創(chuàng)建一個Windows服務(wù)
我們即將創(chuàng)建的這個服務(wù)除了演示什么也不做。服務(wù)被啟動時會把一個條目信息登記到一個數(shù)據(jù)庫當(dāng)中來指明這個服務(wù)已經(jīng)啟動了。在服務(wù)運(yùn)行期間，它會在指定的時間間隔內(nèi)定期創(chuàng)建一個數(shù)據(jù)庫項目記錄。服務(wù)停止時會創(chuàng)建最后一條數(shù)據(jù)庫記錄。這個服務(wù)會自動向Windows應(yīng)用程序日志當(dāng)中登記下它成功啟動或停止時的記錄。
Visual Studio .NET能夠使創(chuàng)建一個Windows服務(wù)變成相當(dāng)簡單的一件事情。啟動我們的演示服務(wù)程序的說明概述如下。
1. 新建一個項目
2. 從一個可用的項目模板列表當(dāng)中選擇Windows服務(wù)
3. 設(shè)計器會以設(shè)計模式打開
4. 從工具箱的組件表當(dāng)中拖動一個Timer對象到這個設(shè)計表面上 (注意: 要確保是從組件列表而不是從Windows窗體列表當(dāng)中使用Timer)
5. 設(shè)置Timer屬性，Enabled屬性為False，Interval屬性30000毫秒
6. 切換到代碼視圖頁(按F7或在視圖菜單當(dāng)中選擇代碼)，然后為這個服務(wù)填加功能
Windows服務(wù)的構(gòu)成
在你類后面所包含的代碼里，你會注意到你所創(chuàng)建的Windows服務(wù)擴(kuò)充了System.ServiceProcess.Service類。所有以.NET方式建立的Windows服務(wù)必須擴(kuò)充這個類。它會要求你的服務(wù)重載下面的方法，Visual Studio默認(rèn)時包括了這些方法。
• Dispose – 清除任何受控和不受控資源(managed and unmanaged resources)
• OnStart – 控制服務(wù)啟動
• OnStop – 控制服務(wù)停止
數(shù)據(jù)庫表腳本樣例
在這個例子中使用的數(shù)據(jù)庫表是使用下面的T-SQL腳本創(chuàng)建的。我選擇SQL Server數(shù)據(jù)庫。你可以很容易修改這個例子讓它在Access或任何你所選擇的別的數(shù)據(jù)庫下運(yùn)行。
CREATE TABLE [dbo].[MyServiceLog] (
[in_LogId] [int] IDENTITY (1, 1) NOT NULL,
[vc_Status] [nvarchar] (40)
COLLATE SQL_Latin1_General_CP1_CI_AS NOT NULL,
[dt_Created] [datetime] NOT NULL
) ON [PRIMARY]
Windows服務(wù)樣例
下面就是我命名為MyService的Windows服務(wù)的所有源代碼。大多數(shù)源代碼是由Visual Studio自動生成的。
using System;
using System.Collections;
using System.ComponentModel;
using System.Data;
using System.Data.SqlClient;
using System.Diagnostics;
using System.ServiceProcess;
namespace CodeGuru.MyWindowsService
{
public class MyService : System.ServiceProcess.ServiceBase
{
private System.Timers.Timer timer1;
/// <remarks>
/// Required designer variable.
/// </remarks>
private System.ComponentModel.Container components = null;
public MyService()
{
// This call is required by the Windows.Forms
// Component Designer.
InitializeComponent();
}
// The main entry point for the process
static void Main()
{
System.ServiceProcess.ServiceBase[] ServicesToRun;
ServicesToRun = new System.ServiceProcess.ServiceBase[]
{ new MyService() };
System.ServiceProcess.ServiceBase.Run(ServicesToRun);
}
/// <summary>
/// Required method for Designer support - do not modify
/// the contents of this method with the code editor.
/// </summary>
private void InitializeComponent()
{
this.timer1 = new System.Timers.Timer();
((System.ComponentModel.ISupportInitialize)
(this.timer1)).BeginInit();
//
// timer1
//
this.timer1.Interval = 30000;
this.timer1.Elapsed +=
new System.Timers.ElapsedEventHandler(this.timer1_Elapsed);
//
// MyService
//
this.ServiceName = "My Sample Service";
((System.ComponentModel.ISupportInitialize)
(this.timer1)).EndInit();
}
/// <summary>
/// Clean up any resources being used.
/// </summary>
protected override void Dispose( bool disposing )
{
if( disposing )
{
if (components != null)
{
components.Dispose();
}
}
base.Dispose( disposing );
}
/// <summary>
/// Set things in motion so your service can do its work.
/// </summary>
protected override void OnStart(string[] args)
{
this.timer1.Enabled = true;
this.LogMessage("Service Started");
}
/// <summary>
/// Stop this service.
/// </summary>
protected override void OnStop()
{
this.timer1.Enabled = false;
this.LogMessage("Service Stopped");
}
/*
* Respond to the Elapsed event of the timer control
*/
private void timer1_Elapsed(object sender,
System.Timers.ElapsedEventArgs e)
{
this.LogMessage("Service Running");
}
/*
* Log specified message to database
*/
private void LogMessage(string Message)
{
SqlConnection connection = null;
SqlCommand command = null;
try
{
connection = new SqlConnection(
"Server=localhost;Database=SampleDatabase;Integrated
Security=false;User Id=sa;Password=;");
command = new SqlCommand(
"INSERT INTO MyServiceLog (vc_Status, dt_Created)
VALUES (‘" + Message + "‘,getdate())", connection);
connection.Open();
int numrows = command.ExecuteNonQuery();
}
catch( Exception ex )
{
System.Diagnostics.Debug.WriteLine(ex.Message);
}
finally
{
command.Dispose();
connection.Dispose();
}
}
}
}
安裝Windows服務(wù)
Windows服務(wù)不同于普通Windows應(yīng)用程序。不可能簡簡單單地通過運(yùn)行一個EXE就啟動Windows服務(wù)了。安裝一個Windows服務(wù)應(yīng)該通過使用.NET Framework提供的InstallUtil.exe來完成，或者通過諸如一個Microsoft Installer (MSI)這樣的文件部署項目完成。
添加服務(wù)安裝程序
創(chuàng)建一個Windows服務(wù)，僅用InstallUtil程序去安裝這個服務(wù)是不夠的。你必須還要把一個服務(wù)安裝程序添加到你的Windows服務(wù)當(dāng)中，這樣便于InstallUtil或是任何別的安裝程序知道應(yīng)用你服務(wù)的是怎樣的配置設(shè)置。
1. 將這個服務(wù)程序切換到設(shè)計視圖
2. 右擊設(shè)計視圖選擇“添加安裝程序”
3. 切換到剛被添加的ProjectInstaller的設(shè)計視圖
4. 設(shè)置serviceInstaller1組件的屬性：
1) ServiceName = My Sample Service
2) StartType = Automatic
5. 設(shè)置serviceProcessInstaller1組件的屬性
1) Account = LocalSystem
6. 生成解決方案
在完成上面的幾個步驟之后，會自動由Visual Studio產(chǎn)生下面的源代碼，它包含于ProjectInstaller.cs這個源文件內(nèi)。
using System;
using System.Collections;
using System.ComponentModel;
using System.Configuration.Install;
namespace CodeGuru.MyWindowsService
{
/// <summary>
/// Summary description for ProjectInstaller.
/// </summary>
[RunInstaller(true)]
public class ProjectInstaller :
System.Configuration.Install.Installer
{
private System.ServiceProcess.ServiceProcessInstaller
serviceProcessInstaller1;
private System.ServiceProcess.ServiceInstaller serviceInstaller1;
/// <summary>
/// Required designer variable.
/// </summary>
private System.ComponentModel.Container components = null;
public ProjectInstaller()
{
// This call is required by the Designer.
InitializeComponent();
// TODO: Add any initialization after the InitComponent call
}
#region Component Designer generated code
/// <summary>
/// Required method for Designer support - do not modify
/// the contents of this method with the code editor.
/// </summary>
private void InitializeComponent()
{
this.serviceProcessInstaller1 = new
System.ServiceProcess.ServiceProcessInstaller();
this.serviceInstaller1 = new
System.ServiceProcess.ServiceInstaller();
//
// serviceProcessInstaller1
//
this.serviceProcessInstaller1.Account =
System.ServiceProcess.ServiceAccount.LocalSystem;
this.serviceProcessInstaller1.Password = null;
this.serviceProcessInstaller1.Username = null;
//
// serviceInstaller1
//
this.serviceInstaller1.ServiceName = "My Sample Service";
this.serviceInstaller1.StartType =
System.ServiceProcess.ServiceStartMode.Automatic;
//
// ProjectInstaller
//
this.Installers.AddRange(new
System.Configuration.Install.Installer[]
{this.serviceProcessInstaller1, this.serviceInstaller1});
}
#endregion
}
}
用InstallUtil安裝Windows服務(wù)
現(xiàn)在這個服務(wù)已經(jīng)生成，你需要把它安裝好才能使用。下面操作會指導(dǎo)你安裝你的新服務(wù)。
1. 打開Visual Studio .NET命令提示
2. 改變路徑到你項目所在的bin\Debug文件夾位置(如果你以Release模式編譯則在bin\Release文件夾)
3. 執(zhí)行命令“InstallUtil.exe MyWindowsService.exe”注冊這個服務(wù)，使它建立一個合適的注冊項。
4. 右擊桌面上“我的電腦”，選擇“管理”就可以打計算機(jī)管理控制臺
5. 在“服務(wù)和應(yīng)用程序”里面的“服務(wù)”部分里，你可以發(fā)現(xiàn)你的Windows服務(wù)已經(jīng)包含在服務(wù)列表當(dāng)中了
6. 右擊你的服務(wù)選擇啟動就可以啟動你的服務(wù)了
在每次需要修改Windows服務(wù)時，這就會要求你卸載和重新安裝這個服務(wù)。不過要注意在卸載這個服務(wù)前，最好確保服務(wù)管理控制臺已經(jīng)關(guān)閉，這會是一個很好的習(xí)慣。如果沒有這樣操作的話，你可能在卸載和重安裝Windows服務(wù)時會遇到麻煩。僅卸載服務(wù)的話，可以執(zhí)行相的InstallUtil命令用于注銷服務(wù)，不過要在后面加一個/u命令開關(guān)。
調(diào)試Windows服務(wù)
從另外的角度度看，調(diào)試Windows服務(wù)絕不同于一個普通的應(yīng)用程序。調(diào)試Windows服務(wù)要求的步驟更多。服務(wù)不能象你對普通應(yīng)用程序做的那樣，只要簡單地在開發(fā)環(huán)境下執(zhí)行就可以調(diào)試了。服務(wù)必須首先被安裝和啟動，這一點(diǎn)在前面部分我們已經(jīng)做到了。為了便于跟蹤調(diào)試代碼，一旦服務(wù)被啟動，你就要用Visual Studio把運(yùn)行的進(jìn)程附加進(jìn)來(attach)。記住，對你的Windows服務(wù)做的任何修改都要對這個服務(wù)進(jìn)行卸載和重安裝。
附加正在運(yùn)行的Windows服務(wù)
為了調(diào)試程序，有些附加Windows服務(wù)的操作說明。這些操作假定你已經(jīng)安裝了這個Windows服務(wù)并且它正在運(yùn)行。
1. 用Visual Studio裝載這個項目
2. 點(diǎn)擊“調(diào)試”菜單
3. 點(diǎn)擊“進(jìn)程”菜單
4. 確保 顯示系統(tǒng)進(jìn)程 被選
5. 在 可用進(jìn)程 列表中，把進(jìn)程定位于你的可執(zhí)行文件名稱上點(diǎn)擊選中它
6. 點(diǎn)擊 附加 按鈕
7. 點(diǎn)擊 確定
8. 點(diǎn)擊 關(guān)閉
9. 在timer1_Elapsed方法里設(shè)置一個斷點(diǎn)，然后等它執(zhí)行
總結(jié)
現(xiàn)在你應(yīng)該對Windows服務(wù)是什么，以及如何創(chuàng)建、安裝和調(diào)試它們有一個粗略的認(rèn)識了。Windows服務(wù)的額處的功能你可以自行研究。這些功能包括暫停(OnPause)和恢復(fù)(OnContinue)的能力。暫停和恢復(fù)的能力在默認(rèn)情況下沒有被啟用，要通過Windows服務(wù)屬性來設(shè)置。
