VS2013开发Windows服务项目
这篇随笔里,我将介绍如何用VS2013开发Windows服务项目,实现的功能是定时发送电子邮件。
开发环境:VS2013,SQL Server2008,采用C#语言开发
步骤一:创建Windows服务项目
首先,有人提问VS2013找不到创建Windows服务项目的选项,答案是在“Windows 桌面”目录下:
步骤二:重命名服务,添加Timer组件
重命名默认创建的Service1服务,比如MyMailService;然后在设计界面添加Timer组件。
这里要注意,VS工具箱默认提供的是System.Windows.Forms.Timer组件,在windows服务中是无法执行的。我们要添加的是System.Timers.Timer组件!
首先,在工具箱空白位置右键打开“选择项”菜单,如下在“.NET Framework组件”页下找到并勾选“Timer”:
然后将从工具箱找到你添加的Timer组件(可利用搜索功能),拖放到编辑区域;
接着,按照你的需要设置Timer的执行间隔,单位是毫秒,比如我是60000,一分钟执行一次。
步骤三:实现服务启动和停止功能
打开MyMailService的代码编辑界面,默认包含3个方法:构造函数、OnStrat和OnStop。
OnStart和OnStop分别对应服务的启动和终止;此外还有OnPause和OnContinue方法,分别对应服务的暂停和继续。
现在,修改代码如下,在服务启动和停止的时候启动和停止Timer定时器:
public MyMailService() { InitializeComponent(); base.AutoLog = false; // 不记录windows事件日志 base.ServiceName = "MyMailService"; timer1.Stop(); } protected override void OnStart(string[] args) { timer1.Start(); } protected override void OnStop() { timer1.Stop(); }
步骤四:实现Timer邮件发送功能
C#发送邮件的例子网上很多,用到System.Net.Mail.MailMessage和System.Net.Mail.SmtpClient。
我按照自己的使用习惯,封装了一个Mail对象:
public class Mail { private string DefaultHost = "smtp.mail.qq.com"; // SMTP服务器,这里是QQ邮箱 private string DefaultFMAddress = "396042321@qq.com"; // 邮箱用户名 private string DefaultName = "默认发送人"; private string DefaultPassword = "XXXXX"; // 邮箱密码 private string DefaultSubject = "系统邮件";
private MailMessage MMsg; private NetworkCredential NC; public Mail() { MMsg = new MailMessage(); MMsg.From = new MailAddress(DefaultFMAddress, DefaultName); MMsg.Subject = DefaultSubject; MMsg.Priority = MailPriority.Normal; MMsg.DeliveryNotificationOptions = DeliveryNotificationOptions.OnSuccess; NC = new NetworkCredential(); NC.UserName = DefaultFMAddress; NC.Password = DefaultPassword; } /// <summary>设置发件人</summary> /// <param name="fmAddress">发件人邮箱</param> /// <param name="fmName">发件人别名</param> public void setFrom(string fmAddress, string fmName) { MMsg.From = new MailAddress(fmAddress, fmName); } /// <summary>添加收件人</summary> /// <param name="toAddress">收件人地址</param> public void AddTo(string toAddress) { string[] adds = toAddress.Split(','); foreach (string add in adds) if (!string.IsNullOrEmpty(add)) MMsg.To.Add(add); } /// <summary>添加抄送人</summary> /// <param name="ccAddress">抄送人地址</param> public void AddCC(string ccAddress) { if (!string.IsNullOrEmpty(ccAddress)) MMsg.CC.Add(ccAddress); } /// <summary>邮件主题</summary> public string Subject { set { MMsg.Subject = value; } } /// <summary>邮件正文</summary> public string Content { set { MMsg.Body = value; MMsg.BodyEncoding = System.Text.Encoding.UTF8; MMsg.IsBodyHtml = true; } } /// <summary>添加附件:文件名UTF8编码不得超过41字节,否则附件无法打开</summary> /// <param name="path">附件的物理路径</param> public void AddAttchment(string path) { if (!string.IsNullOrEmpty(path)) { string[] atts = path.Split(','); foreach (string att in atts) { if (!System.IO.File.Exists(att)) throw new Exception("找不到附件:" + att); else MMsg.Attachments.Add(new Attachment(att)); } } } /// <summary>发送级别</summary> public MailPriority Priority { set { MMsg.Priority = value; } } /// <summary>发送邮件</summary> public void Send() { SmtpClient sc = new SmtpClient(); sc.UseDefaultCredentials = true; sc.DeliveryMethod = SmtpDeliveryMethod.Network; sc.Credentials = NC; sc.Host = DefaultHost; sc.Send(MMsg); MMsg.Dispose(); // 发送邮件后释放对象 } }
Timer的代码:
private void timer1_Elapsed(object sender, System.Timers.ElapsedEventArgs e) { Mail mail = new Mail(); mail.AddTo("396042321@qq.com"); // 收件人 mail.AddCC("396042321@qq.com"); // 抄送人 mail.Subject = "主题"; mail.Content = "邮件正文"; mail.AddAttchment("C:\test.txt"); // 附件 mail.Send(); }
步骤五:添加服务安装程序
打开MyMailService的设计视图,在空白位置右键选择“添加安装程序”,VS自动创建一个ProjectInstaller。
设置serviceProcessInstaller1的Account属性为LocalSystem;
设置serviceInstaller1的ServiceName为MyMailService,StartType为Automatic,Description为“用于自动发送电子邮件”,DisplayName为“定时发送邮件服务”
(这里若设置DelayedAutoStart为True,则服务在系统启动一段时候后自动启动,否则在系统启动时启动)
步骤六:生成项目,安装到系统服务
选中项目右键选择“生成”,生成exe文件;
然后在生成目录下新建“安装.bat”文件,使用记事本打开,输入如下命令:
C:\Windows\Microsoft.NET\Framework\v4.0.30319\InstallUtil.exe CYWinService.exe pause
注意:这里要填写你的InstallUtil.exe的所在路径
最后双击安装.bat文件,就完成服务注册了。
在我的电脑上右键选择“管理”,打开“服务和应用程序”下的“服务”,就能看到我们注册的服务了。
后记:
(1)如何卸载我注册的Windows服务?
在生成目录下新建“卸载.bat”文件,输入如下命令:
C:\Windows\Microsoft.NET\Framework\v4.0.30319\InstallUtil.exe /u CYWinService.exe pause
双击执行卸载.bat文件,即可卸载服务。
(2)改进:从数据库读取要发送的邮件信息,然后定时发送
修改Timer的代码改为动态读取即可,具体代码就不贴了,我的表结构是:
TABLE [dbo].[t_SYS_Mail]( [ID] [int] IDENTITY(1,1) NOT NULL,
[FmSMTP] [varchar](50) NULL, -- 邮箱SMTP [FmWho] [varchar](50) NULL, -- 发送人邮箱 [FmPassword] [varchar](50) NULL, -- 发送人邮箱密码 [FmName] [varchar](50) NULL, -- 显示的发送人名称 [ToWho] [varchar](100) NOT NULL, -- 收件人 [CCWho] [varchar](100) NULL, -- 抄送人 [MailSubject] [varchar](100) NOT NULL, -- 主题 [MailContent] [varchar](500) NOT NULL, -- 正文 [MailPriority] [varchar](50) NULL, -- 优先级 [MailAttchments] [varchar](500) NULL, -- 附件 [AddTime] [datetime] NULL, [SendTime] [datetime] NULL, [ErrMessage] [varchar](100) NULL)
用SendTime记录发送时间,ErrMessage记录发送错误信息