在開放原始碼專案 Topshelf .NET 套件的協助下，Windows 服務的開發、設定與實作變得更容易。 透過消除建立 Windows 服務過程中的許多複雜性，開發人員能夠更專注於應用程式的基本功能，而非 Windows 服務管理的細微差異。

Topshelf 只需修改很少的程式碼，就能讓開發人員輕鬆地將主控台應用程式轉換為服務。 它也提供了流暢的 API 來建立服務設定，包括相依性、復原選項，以及啟動和停止服務的動作。 對於希望有效建立穩定且可管理的 Windows 服務的 .NET 開發人員而言，Topshelf 因其易用性與適應性而深受喜愛。

Topshelf 提供的多項功能可讓您更輕鬆地在 .NET 中設計及維護 Windows 服務。 以下是其幾項突出特質：

易用性

Topshelf 提供基本且流暢的 API，可簡化使用它設定和管理 Windows 服務的流程。 控制台應用程式可由開發人員輕鬆轉換為服務，幾乎不需修改程式碼。

配置的靈活性

開始、停止、暫停和繼續動作是它支援的組態選項。 服務的依賴性和服務類別的復原選項也可以由開發人員指定。

安裝與卸載

Topshelf 內建的安裝與卸載服務功能，有助於部署使用 .NET Framework 寫成的主機服務。 可透過程式或命令列安裝服務。

記錄

Topshelf 透過整合知名的日誌框架（如 log4net、NLog 和 Serilog），促進開發人員有效記錄服務作業和故障的能力。

服務控制

它相容於所有常見的 Windows 服務控制，例如暫停、繼續、開始和停止。開發人員現在可以完全控制整個服務生命週期。

異常處理

強大的異常處理是 Topshelf 的一項功能，可保證服務能夠優雅地處理故障並保持穩定。

多重服務實體

它可在同一應用程式中建立和管理多個服務實體，為複雜的服務架構提供彈性。

自訂命令列選項

自訂指令列選項可讓開發人員進一步自訂及控制服務的行為。

環境意識

無論是生產伺服器、測試環境或開發系統，Topshelf 都能辨識並適應周遭環境。

支援依賴注入。

Topshelf 與相依性注入框架結合使用時，可促進更好的軟體架構，並讓服務相依性的管理變得更容易。

跨平台能力

Topshelf 主要是為 Windows 所製作，但在利用 .NET Core 時，它也可以在 Linux 和 macOS 上執行服務，這增加了它與其他作業系統的相容性。

建立和配置 Topshelf C#。

Install-Package Topshelf

using System;
using Topshelf;

namespace MyWindowsService
{
    // Define a simple service class with Start and Stop methods
    public class MyService
    {
        public bool Start()
        {
            // Service start logic
            Console.WriteLine("Service Started.");
            return true;
        }

        public bool Stop()
        {
            // Service stop logic
            Console.WriteLine("Service Stopped.");
            return true;
        }
    }

    // Main program class to run the Topshelf service
    class Program
    {
        static void Main(string[] args)
        {
            HostFactory.Run(x =>
            {
                // Configure the service
                x.Service<MyService>(s =>
                {
                    s.ConstructUsing(name => new MyService());
                    s.WhenStarted(tc => tc.Start());
                    s.WhenStopped(tc => tc.Stop());
                });

                // Run the service as a local system
                x.RunAsLocalSystem();

                // Set service details
                x.SetServiceName("MyService");
                x.SetDisplayName("My Service");
                x.SetDescription("This is a sample service created using Topshelf.");
            });
        }
    }
}

using System;
using Topshelf;

namespace MyWindowsService
{
    // Define a simple service class with Start and Stop methods
    public class MyService
    {
        public bool Start()
        {
            // Service start logic
            Console.WriteLine("Service Started.");
            return true;
        }

        public bool Stop()
        {
            // Service stop logic
            Console.WriteLine("Service Stopped.");
            return true;
        }
    }

    // Main program class to run the Topshelf service
    class Program
    {
        static void Main(string[] args)
        {
            HostFactory.Run(x =>
            {
                // Configure the service
                x.Service<MyService>(s =>
                {
                    s.ConstructUsing(name => new MyService());
                    s.WhenStarted(tc => tc.Start());
                    s.WhenStopped(tc => tc.Stop());
                });

                // Run the service as a local system
                x.RunAsLocalSystem();

                // Set service details
                x.SetServiceName("MyService");
                x.SetDisplayName("My Service");
                x.SetDescription("This is a sample service created using Topshelf.");
            });
        }
    }
}

MyWindowsService.exe install

MyWindowsService.exe install

MyWindowsService.exe start

MyWindowsService.exe start

MyWindowsService.exe uninstall

MyWindowsService.exe uninstall

什麼是 IronPDF？

IronPDF for .NET Libraries 是一個功能豐富的 .NET 函式庫，C# 程式可用來建立、讀取和編輯 PDF 文件。 透過此程式，開發人員可以輕鬆地將 HTML、CSS 和 JavaScript 內容製作成可供列印的高品質 PDF。 拆分與合併 PDF、為文件加上水印、新增頁首與頁尾，以及將 HTML 轉換為 PDF 是其中幾項基本功能。 IronPDF 同時支援 .NET Framework 和 .NET Core，因此適用範圍廣泛。

由於 PDF 簡單易用且有豐富的說明文件，因此開發人員可以輕鬆地將 PDF 整合到他們的程式中。 IronPDF 可輕鬆處理複雜的版面和格式，確保產生的 PDF 與原始 HTML 內容非常相似。

IronPDF 的特點

從 HTML 產生 PDF

將 JavaScript、HTML 和 CSS 轉換為 PDF。 支援媒體查詢和回應式設計這兩項當代網路標準。 對於使用 HTML 和 CSS 動態裝飾 PDF 帳單、報告和文件非常有用。

PDF編輯

預先存在的 PDF 可以加入文字、照片和其他內容。 從 PDF 檔案中萃取文字和圖片。 將眾多 PDF 合併為一個檔案。將 PDF 檔案分割成多個獨立的文件。 包括水印、註解、頁首和頁尾。

PDF 轉檔

將多種檔案格式（包括 Word、Excel 和圖片檔案）轉換為 PDF 格式。 PDF 到圖像的轉換（PNG、JPEG 等）。

效能與可靠性

在工業環境中，高效能和可靠度是理想的設計品質。 輕鬆管理大型文件集。

安裝 IronPDF

要獲得在 .NET 專案中使用 PDF 所需的工具，請安裝 IronPDF 套件。

Install-Package IronPdf

使用 IronPdf 創建您的服務類型。

定義 IronPDF 用於建立和修改 PDF 檔案的功能，以及該類的服務邏輯。

using System;
using IronPdf;
using Topshelf;

namespace PdfService
{
    // Define a service class with PDF generation logic
    public class MyPdfService
    {
        public bool Start()
        {
            Console.WriteLine("Service Starting...");
            GeneratePdf();
            return true;
        }

        public bool Stop()
        {
            Console.WriteLine("Service Stopping...");
            return true;
        }

        // Method to generate a PDF using IronPDF
        private void GeneratePdf()
        {
            var renderer = new HtmlToPdf();
            var pdf = renderer.RenderHtmlAsPdf("<h1>Hello, PDF!</h1>");
            pdf.SaveAs("GeneratedDocument.pdf");
            Console.WriteLine("PDF Generated.");
        }
    }

    // Main program to configure and run the service using Topshelf
    class Program
    {
        static void Main(string[] args)
        {
            HostFactory.Run(x =>
            {
                x.Service<MyPdfService>(s =>
                {
                    s.ConstructUsing(name => new MyPdfService());
                    s.WhenStarted(tc => tc.Start());
                    s.WhenStopped(tc => tc.Stop());
                });

                x.RunAsLocalSystem();
                x.SetServiceName("MyPdfService");
                x.SetDisplayName("My PDF Service");
                x.SetDescription("A service that generates PDF files using IronPDF and Topshelf.");
            });
        }
    }
}

using System;
using IronPdf;
using Topshelf;

namespace PdfService
{
    // Define a service class with PDF generation logic
    public class MyPdfService
    {
        public bool Start()
        {
            Console.WriteLine("Service Starting...");
            GeneratePdf();
            return true;
        }

        public bool Stop()
        {
            Console.WriteLine("Service Stopping...");
            return true;
        }

        // Method to generate a PDF using IronPDF
        private void GeneratePdf()
        {
            var renderer = new HtmlToPdf();
            var pdf = renderer.RenderHtmlAsPdf("<h1>Hello, PDF!</h1>");
            pdf.SaveAs("GeneratedDocument.pdf");
            Console.WriteLine("PDF Generated.");
        }
    }

    // Main program to configure and run the service using Topshelf
    class Program
    {
        static void Main(string[] args)
        {
            HostFactory.Run(x =>
            {
                x.Service<MyPdfService>(s =>
                {
                    s.ConstructUsing(name => new MyPdfService());
                    s.WhenStarted(tc => tc.Start());
                    s.WhenStopped(tc => tc.Stop());
                });

                x.RunAsLocalSystem();
                x.SetServiceName("MyPdfService");
                x.SetDisplayName("My PDF Service");
                x.SetDescription("A service that generates PDF files using IronPDF and Topshelf.");
            });
        }
    }
}

開發人員可透過結合 Topshelf 與 IronPDF in C#，快速設計出強大的 Windows 服務，以進行 PDF 生產與操作。 Topshelf 提供流暢且人性化的 API，讓 Windows 服務的設定與管理變得更容易。

MyPdfService 類實作了啟動（Start）和結束（Stop）服務的方法，該類封裝了所給示例中的服務邏輯。 IronPDF 使用 Start 方法從 HTML 文字建立一個簡單的 使用 HTML 的 PDF 文件。 The ability to render HTML into a PDF format using IronPDF's HtmlToPdf class is demonstrated, showing how to turn basic HTML information (such as "

Hello, PDF!

此整合示範了 Topshelf 如何管理服務的生命週期，以確保它能像完整的 Windows 服務一樣運作，以及 IronPDF 如何管理輕鬆建立 PDF 的高難度流程。 透過 Topshelf 與 IronPDF 在 C# 中的結合功能，此整合非常適合需要自動化文件建立或修改的應用程式。 它提供了可靠性和易維護性。