C#/.NET基于Topshelf创建Windows服务程序及服务的安装和卸载

栏目: C# · 发布时间: 4年前

内容简介:本文首发于C#/.NET基于Topshelf创建Windows服务的系列文章目录:对于使用Windows操作系统的人来说,Windows Service(Windows服务)应该不会陌生。在Windows操作系统中,我们可以在"运行"窗口中运行

本文首发于 码友网 --一个专注.NET/.NET Core开发的编程爱好者社区。

文章目录

C#/.NET基于Topshelf创建Windows服务的系列文章目录:

  1. C#/.NET基于Topshelf创建Windows服务程序及服务的安装和卸载 (1)
  2. 在C#/.NET应用程序开发中创建一个基于Topshelf的应用程序守护进程(服务) (2)
  3. C#/.NET基于Topshelf创建Windows服务的守护程序作为服务启动的客户端桌面程序不显示UI界面的问题分析和解决方案 (3)

前言

对于使用Windows操作系统的人来说,Windows Service(Windows服务)应该不会陌生。在Windows操作系统中,我们可以在"运行"窗口中运行 service.msc

C#/.NET基于Topshelf创建Windows服务程序及服务的安装和卸载

即可打开一个查看Windows服务的窗口,如图:

C#/.NET基于Topshelf创建Windows服务程序及服务的安装和卸载

Windows服务基本都是一些后台运行的服务进程,没有UI界面,每个服务处理着各自独立的任务并且有专门的启动或者停止策略。所以,Windows服务在很多情况下会被用来者处理一些定时任务或者调度。

那么,对于.NET的开发者来说,可不可以自己创建Windows服务呢,如何使用C#创建Windows服务呢?

本文就为大家分享一种基于Topshelf创建的Windows服务的方法。

创建Topshelf服务项目

首先打开Visual Studio(本文使用的是Visual Studio 2019),打开新建项目的对话框,选择.NET Framework的控制台应用程序(Console App(.NET Framework)),如图:

C#/.NET基于Topshelf创建Windows服务程序及服务的安装和卸载

注:只可选择控制台应用程序

点击"下一步",在项目名称中输入 TopshelfDemoService ,.NET Framework 选择4.6.2,其中选项根据自己情况填写即可,最后点击"创建"按钮。

安装Topshelf组件

TopshelfDemoService 项目中,打开Nuget包管理工具,搜索 Topshelf ,在搜索结果中选中 Topshelf ,点击"安装",如图:

C#/.NET基于Topshelf创建Windows服务程序及服务的安装和卸载

编写Topshelf服务的示例程序代码

Topshelf 组件安装完成后,我们就可以开始编写服务的示例代码了。

首先,创建一个名为 HealthMonitorService.cs 的类(其作用假设为定时监控某个系统的运行健康状况),在其中分别创建方法: Start()Stop() 以及一个定时器,让定时器定时执行检查系统健康状况的任务(这里模拟的每秒向控制台输出一条文本信息),完整的代码如下:

using System;
using System.Timers;

namespace TopshelfDemoService
{
    internal class HealthMonitorService
    {
        private readonly Timer _timer;
        public HealthMonitorService()
        {
            _timer = new Timer(1000) { AutoReset = true };
            _timer.Elapsed += (sender, eventArgs) => Console.WriteLine("执行系统健康检查任务,所有指标均正常。执行时间:{0}", DateTime.Now);
        }

        public void Start()
        {
            _timer.Start();
        }
        public void Stop()
        {
            _timer.Stop();
        }
    }
}

再创建一个名为 MyServiceConfigure.cs 的服务配置类,这个类主要用来配置Topshelf服务的各种运行参数,代码如下:

using System;
using Topshelf;

namespace TopshelfDemoService
{
    internal class MyServiceConfigure
    {
        internal static void Configure()
        {
            var rc = HostFactory.Run(host =>                                    // 1
            {
                host.Service<HealthMonitorService>(service =>                   // 2
                {
                    service.ConstructUsing(() => new HealthMonitorService());   // 3
                    service.WhenStarted(s => s.Start());                        // 4
                    service.WhenStopped(s => s.Stop());                         // 5
                });

                host.RunAsLocalSystem();                                        // 6

                host.EnableServiceRecovery(service =>                           // 7
                {
                    service.RestartService(3);                                  // 8
                });
                host.SetDescription("Windows service based on topshelf");       // 9
                host.SetDisplayName("Topshelf demo service");                   // 10
                host.SetServiceName("TopshelfDemoService");                     // 11
                host.StartAutomaticallyDelayed();                               // 12
            });

            var exitCode = (int)Convert.ChangeType(rc, rc.GetTypeCode());       // 13
            Environment.ExitCode = exitCode;
        }
    }
}

注:其中数字的含义请见本文末尾的解释。

最后,打开 Program.cs 文件,开启 Topshelf 服务,如下:

namespace TopshelfDemoService
{
    class Program
    {
        static void Main(string[] args)
        {
            MyServiceConfigure.Configure();
        }
    }
}

好了,完成到这里,整个示例程序就写好了,按F5运行示例程序,你将看到如下类似的控制台信息:

C#/.NET基于Topshelf创建Windows服务程序及服务的安装和卸载

可以看到,我们创建的 TopshelfDemoService 服务每秒向控制台打印了一条文本信息,这和我们的预期是吻合的。

这样,我们就成功创建了一个基于 Topshelf 的Windows服务,当然,这也只是一个简单和示例服务程序,其中没有复杂的业务逻辑和配置等等。这些都等待你去发掘。

作为Windows服务安装和卸载

我们刚才运行的只是一个控制台应用程序,如果将这个控制台应用程序关掉,定时任务也会被停止了。如果我们希望定时任务可以一直运行,那需要将这个控制台应用程序作为服务安装到Windows服务进程中,如何操作呢?

非常简单的安装和卸载命令。

首先,以 管理员身份 打开一个命令行工具,进入到控制台应用程序所在目录。

安装

安装服务运行如下命令:

TopshelfDemoService.exe install

C#/.NET基于Topshelf创建Windows服务程序及服务的安装和卸载

打开Windows服务查看窗口(刷新),可以看到 Topshelf demo service 已经在服务列表中了,如图:

C#/.NET基于Topshelf创建Windows服务程序及服务的安装和卸载

这时,我们只需要按照Windows服务来操作这个服务即可。

卸载

如果需要卸载服务,则运行如下命令:

TopshelfDemoService.exe uninstall

Topshelf配置参数说明

1.设置服务主机使用 HostFactory.Run() 来创建并运行一个Topshelft服务。

2.设置 Topshelf 使用类型 HealthMonitorService 作为服务类。

3.配置如何创建一个服务的实例,这里采用的是使用关键字 new 来实例化一个 HealthMonitorService 对象,你也可以使用IoCp容器来实例化服务对象。

4.设置当服务启动时执行的操作。

5.设置当服务停止时执行的操作。

6.设置将服务以本地系统身份运行。

7.启动恢复服务模式(当服务意外停止后自动恢复)。

8.设置第一次自动恢复服务的延迟时间为3分钟。

9.设置Topshelf服务在Windows服务中的描述信息。

10.设置Topshelf服务在Windows服务中的显示名称。

11.设置Topshelf服务在Windows服务中的服务名称。

12.设置Topshelf服务随Windows启动时自动运行(延迟)。

13.设置服务的退出代码。

示例代码托管和下载

本示例代码托管地址可以在原出处找到: 示例代码下载地址


以上所述就是小编给大家介绍的《C#/.NET基于Topshelf创建Windows服务程序及服务的安装和卸载》,希望对大家有所帮助,如果大家有任何疑问请给我留言,小编会及时回复大家的。在此也非常感谢大家对 码农网 的支持!

查看所有标签

猜你喜欢:

本站部分资源来源于网络,本站转载出于传递更多信息之目的,版权归原作者或者来源机构所有,如转载稿涉及版权问题,请联系我们

老码识途

老码识途

韩宏 / 电子工业出版社 / 2012-8 / 56.00元

《老"码"识途:从机器码到框架的系统观逆向修炼之路》以逆向反汇编为线索,自底向上,从探索者的角度,原生态地刻画了对系统机制的学习,以及相关问题的猜测、追踪和解决过程,展现了系统级思维方式的淬炼方法。该思维方式是架构师应具备的一种重要素质。《老"码"识途:从机器码到框架的系统观逆向修炼之路》内容涉及反汇编、底层调试、链接、加载、钩子、异常处理、测试驱动开发、对象模型和机制、线程类封装、跨平台技术、插......一起来看看 《老码识途》 这本书的介绍吧!

JSON 在线解析
JSON 在线解析

在线 JSON 格式化工具

Markdown 在线编辑器
Markdown 在线编辑器

Markdown 在线编辑器

UNIX 时间戳转换
UNIX 时间戳转换

UNIX 时间戳转换