推薦一款將控制台程式部署到Windows服務的組件

来源:https://www.cnblogs.com/hsiang/p/18317307
-Advertisement-
Play Games

在日常開發中,有時候需要將我們的程式隨著操作系統一起運行,並且無需人工干預。要實現這種效果,有很多種方法,比如:如果是桌面程式,可以設置到程式的啟動項;如果是Web程式,還可以托管到IIS中,而對於控制台程式,最常見在做法是將程式部署成Windows服務,並設置成自動運行,這樣當操作系統開機時,就會... ...


在日常開發中,有時候需要將我們的程式隨著操作系統一起運行,並且無需人工干預。要實現這種效果,有很多種方法,比如:如果是桌面程式,可以設置到程式的啟動項;如果是Web程式,還可以托管到IIS中,而對於控制台程式,最常見在做法是將程式部署成Windows服務,並設置成自動運行,這樣當操作系統開機時,就會自動啟動。在.NET程式中,如何將控制台程式,部署成Windows服務中呢?本文以一個簡單的小例,簡述如何利用一款第三方插件(Topshelf)將控制台程式部署成Windows服務的相關方法及步驟。

 

什麼是Topshelf?

 

Topshelf是一款開源的用於托管.NET編寫的應用程式到Windows服務的框架,通過Topshelf,可以非常方便的將普通控制台應用程式,轉換成Winodw服務,並註冊到Windows服務控制管理器(SCM)中。

 

示例說明

 

Windows服務一般都是周期性重覆運行的,並不會停止。在本示例中,主要是為了演示創建Windows服務的方法及功能框架,實現功能是每隔一秒鐘,輸入一段話到日誌文件中,以便於查看。

 

創建控制台應用程式

 

首先創建一個控制台應用程式,以及一個普通的類(AppService),此類包含Start和Stop方法,以及Work方法,具備一個服務的基本功能。如下所示:

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;

namespace DemoWinService
{
    /// <summary>
    /// 程式運行主體
    /// </summary>
    internal class AppService
    {
        private CancellationTokenSource cts;
        private CancellationToken token;
        private Task bgtask;

        public AppService()
        {
            this.cts = new CancellationTokenSource();
            this.token = cts.Token;
        }

        /// <summary>
        /// 開始
        /// </summary>
        public void Start()
        {
            Logger.Info("DemoWinService程式開始運行"); 
            this.bgtask = Task.Run(() =>
            {
                while (!this.token.IsCancellationRequested)
                {
                    try
                    {
                        this.Work();
                    }
                    catch (Exception ex)
                    {

                    }
                    finally
                    {
                        Sleep(1000);
                    }
                }

            });
        }

        /// <summary>
        /// 運行
        /// </summary>
        public void Work()
        {
            Logger.Info($"{DateTime.Now.ToString("當前時間為:yyyy-MM-dd HH:mm:ss")}程式正在運行...");
        }

        /// <summary>
        /// 停止
        /// </summary>
        public void Stop()
        {
            cts.Cancel();
            if(this.bgtask != null)
            {
                this.bgtask.Wait(1000);
            }
            Logger.Info("DemoWinService程式結束運行");
        }

        /// <summary>
        /// 線程等待
        /// </summary>
        /// <param name="milliseconds"></param>
        private void Sleep(int milliseconds)
        {
            int times = 10;
            if (milliseconds <= 1000)
            {
                times = 10;
            }
            else if (milliseconds > 1000 && milliseconds <= 10000)
            {
                times = 20;
            }
            else if (milliseconds > 10000 && milliseconds <= 100000)
            {
                times = 40;
            }
            else
            {
                times = 60;
            }
            for (int i = 0; i < times; i++)
            {
                if (token.IsCancellationRequested)
                {
                    return;
                }
                Thread.Sleep(milliseconds / times);
            }
        }
    }
}

 

安裝Topshelf組件

 

在Visual Studio開發工具中,可以通過Nuget包管理器進行安裝,如下所示:

 

配置註冊Windows服務

 

在Program的Main方法中,通過HostFactory的Run方法,註冊Windows服務,如下所示:

using System;
using System.Collections.Generic;
using System.Configuration;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using Topshelf;

namespace DemoWinService
{
    internal class Program
    {
        public static void Main(string[] args)
        {
            var rc = HostFactory.Run(x =>
            {
                x.Service<AppService>(s =>
                {
                    s.ConstructUsing(name => new AppService());
                    s.WhenStarted(tc => tc.Start());
                    s.WhenStopped(tc => tc.Stop());
                });
                x.RunAsLocalSystem();
                x.StartAutomatically();
                x.SetDescription(ConfigurationManager.AppSettings["Description"]);

                x.SetDisplayName(ConfigurationManager.AppSettings["DisplayName"]);
                x.SetServiceName(ConfigurationManager.AppSettings["ServiceName"]);
            });

            var exitCode = (int)Convert.ChangeType(rc, rc.GetTypeCode());

            Environment.ExitCode = exitCode;
        }
    }
}

 其中服務名稱和描述信息,在配置文件(App.config)中,方便修改。

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
	<appSettings>
		<add key="Description" value="測試Windows服務"/>
		<add key="ServiceName" value="DemoWinService"/>
		<add key="DisplayName" value="DemoWinService"/>
	</appSettings>
</configuration>

 

服務安裝

 

當程式開發完成後,將編譯後的程式放置在伺服器上指定的目錄,然後【以管理員運行】打開命令行視窗,找到程式目錄,通過以下命令進行安裝:

可執行程式.exe install

 示例如下所示:

 

啟動停止服務

 

安裝成功後,即可在Windows服務管理器中,進行啟動或者停止 ,如下所示:

 

 

程式輸出日誌,表示服務正常運行:

 

 

服務卸載

 

當服務不再使用時,可以通過如下命令卸載服務:

可執行程式.exe uninstall

 

示例如下所示:

 

Topshelf源碼

 

Topshelf是一款開源框架,其源碼是托管到Github中,如下所示:

GitHub源碼:https://github.com/Topshelf/Topshelf

 

以上就是【推薦一款將控制台程式部署到Windows服務的組件】的全部內容,希望可以拋磚引玉,一起學習,共同進步。


作者:老碼識途
出處:http://www.cnblogs.com/hsiang/
本文版權歸作者和博客園共有,寫文不易,支持原創,歡迎轉載【點贊】,轉載請保留此段聲明,且在文章頁面明顯位置給出原文連接,謝謝。
關註個人公眾號,定時同步更新技術及職場文章


您的分享是我們最大的動力!

-Advertisement-
Play Games
更多相關文章
  • C#進階之WebAPI(一) 那麼首先第一點:什麼是WebAPI? 首先我們瞭解一下.net framework 的框架構成: 可以看到,WebAPI和mvc同屬於B/S模板框架的一種,官方對於WebApi的定義是:WebAPI是一個框架,可以輕鬆構建HTTP服務,覆蓋廣泛的客戶端,包括瀏覽器和移動 ...
  • 最近有需求從第三方獲取到ofd文件後,需要轉pdf,1.目前看的有一個免費的插件,需要安裝程式包 FreeSpire.PDF 安裝後,直接引用 // odf文件地址 string path = @"D:\OFD\20240725\吳天.ofd"; OfdConverter converter = n ...
  • 做.NET應用開發肯定會用到網路通信,而進程間通信是客戶端開發使用頻率較高的場景。 進程間通信方式主要有命名管道、消息隊列、共用記憶體、Socket通信,個人使用最多的是Sokcet相關。 而Socket也有很多使用方式,Socket、WebSocket、TcpClient、UdpClient,是不是 ...
  • 很多.NET開發者編譯好的的程式,發佈到另外一臺電腦的時候,往往都不能運行,而是需要安裝運行時。這個大多數人都知道,直接去運行時官網下載對應版本的安裝包即可。比如我用了6.0,那麼選擇對應架構的版本下載即可。然後在目標機器上安裝這個包,就可以運行我們的.NET程式了。 這樣操作起來還是有點麻煩,有沒 ...
  • 前言 當我們需要快速測試代碼片段時,常見的做法是啟動Visual Studio或使用線上代碼編輯器。然而,Visual Studio的啟動可能較為緩慢且占用較多系統資源,而線上編輯器則可能遇到語法支持局限或網路延遲問題。 為解決這個問題,給大家推薦一款輕量級的本地C#執行工具——CSharpRepl ...
  • Spectre.Console.NET程式員可能都不陌生,寫控制台程式美化還是不錯的,支持著色,表格,圖標等相當Nice,如果對這個庫不熟悉我強烈推薦你瞭解一下,Spectre.Console.Cli作為Spectre.Console的子集,對於寫一些CLI小工具還是相當方便 本文主要講講 Spec ...
  • 一.事件回放二.主要問題剖析三.對博客園團隊的忠告 一.事件回放7 月 15 日,知名的經典博客站點 —— 博客園再次發佈了求救信,大概的意思是說現在園子又到了生死攸關的時候,需要開發者開通會員來相救。我用紅圈給大家標註了一些重點: 可以看出園子現在真的是很難了。。。不管怎麼樣,作為在博客園多年的作 ...
  • 前置 移除連接 要刪除連接,只需監聽來自連接器本身或編輯器的斷開連接事件,並刪除具有連接器作為源或目標的連接。為了簡單起見,我們將為 NodifyEditor 實現 DisconnectConnectorCommand。首先讓我們將其添加到 EditorViewModel。 public class ...
一周排行
    -Advertisement-
    Play Games
  • 示例項目結構 在 Visual Studio 中創建一個 WinForms 應用程式後,項目結構如下所示: MyWinFormsApp/ │ ├───Properties/ │ └───Settings.settings │ ├───bin/ │ ├───Debug/ │ └───Release/ ...
  • [STAThread] 特性用於需要與 COM 組件交互的應用程式,尤其是依賴單線程模型(如 Windows Forms 應用程式)的組件。在 STA 模式下,線程擁有自己的消息迴圈,這對於處理用戶界面和某些 COM 組件是必要的。 [STAThread] static void Main(stri ...
  • 在WinForm中使用全局異常捕獲處理 在WinForm應用程式中,全局異常捕獲是確保程式穩定性的關鍵。通過在Program類的Main方法中設置全局異常處理,可以有效地捕獲並處理未預見的異常,從而避免程式崩潰。 註冊全局異常事件 [STAThread] static void Main() { / ...
  • 前言 給大家推薦一款開源的 Winform 控制項庫,可以幫助我們開發更加美觀、漂亮的 WinForm 界面。 項目介紹 SunnyUI.NET 是一個基於 .NET Framework 4.0+、.NET 6、.NET 7 和 .NET 8 的 WinForm 開源控制項庫,同時也提供了工具類庫、擴展 ...
  • 說明 該文章是屬於OverallAuth2.0系列文章,每周更新一篇該系列文章(從0到1完成系統開發)。 該系統文章,我會儘量說的非常詳細,做到不管新手、老手都能看懂。 說明:OverallAuth2.0 是一個簡單、易懂、功能強大的許可權+可視化流程管理系統。 有興趣的朋友,請關註我吧(*^▽^*) ...
  • 一、下載安裝 1.下載git 必須先下載並安裝git,再TortoiseGit下載安裝 git安裝參考教程:https://blog.csdn.net/mukes/article/details/115693833 2.TortoiseGit下載與安裝 TortoiseGit,Git客戶端,32/6 ...
  • 前言 在項目開發過程中,理解數據結構和演算法如同掌握蓋房子的秘訣。演算法不僅能幫助我們編寫高效、優質的代碼,還能解決項目中遇到的各種難題。 給大家推薦一個支持C#的開源免費、新手友好的數據結構與演算法入門教程:Hello演算法。 項目介紹 《Hello Algo》是一本開源免費、新手友好的數據結構與演算法入門 ...
  • 1.生成單個Proto.bat內容 @rem Copyright 2016, Google Inc. @rem All rights reserved. @rem @rem Redistribution and use in source and binary forms, with or with ...
  • 一:背景 1. 講故事 前段時間有位朋友找到我,說他的窗體程式在客戶這邊出現了卡死,讓我幫忙看下怎麼回事?dump也生成了,既然有dump了那就上 windbg 分析吧。 二:WinDbg 分析 1. 為什麼會卡死 窗體程式的卡死,入口門檻很低,後續往下分析就不一定了,不管怎麼說先用 !clrsta ...
  • 前言 人工智慧時代,人臉識別技術已成為安全驗證、身份識別和用戶交互的關鍵工具。 給大家推薦一款.NET 開源提供了強大的人臉識別 API,工具不僅易於集成,還具備高效處理能力。 本文將介紹一款如何利用這些API,為我們的項目添加智能識別的亮點。 項目介紹 GitHub 上擁有 1.2k 星標的 C# ...