開源專案Topshelf .NET套件簡化了Windows服務的開發、設置和實施。 透過在建立Windows服務的過程中去除了許多複雜性，開發者能更專注於應用的核心功能，而非Windows服務管理的細節。

Topshelf使開發者對應用進行少量程式碼更改即可輕鬆將控制台應用轉換為服務。 它還提供了一個流暢的API，用於設定服務設置，包括依賴性、恢復選項以及啟動和停止服務的動作。 對於希望有效地建立穩定且可管理的Windows服務的.NET開發者來說，Topshelf是一個受歡迎的選擇，因為它的易用性和適應性。

Topshelf提供的多個功能使得在.NET中設計和維護Windows服務變得更輕鬆。 以下是其幾個突出特點：

易用性

Topshelf提供了一個基本而流暢的API，以簡化使用它來配置和管理Windows服務的過程。 開發者可以通過少量或無需程式碼修改即可將控制台應用輕鬆轉換為服務。

配置靈活性

它支持啟動、停止、暫停和繼續等配置選項。 開發者還可以為服務類別指定服務依賴性和恢復選項。

安裝和解除安裝

使用.NET Framework編寫的託管服務的部署是透過Topshelf內建的安裝和解除安裝服務功能促成的。 服務可以程式化或通過命令行進行安裝。

日誌

Topshelf通過與知名的日誌框架如log4net、NLog和Serilog的整合，提高了開發者高效記錄服務操作和故障的能力。

服務控制

它與所有常見的Windows服務控制相容，如暫停、繼續、啟動和停止。開發者現在對整個服務生命周期擁有完全的控制。

異常處理

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

多個服務實例

透過允許在同一應用中建立和管理多個服務實例，它提供了複雜服務架構的靈活性。

自訂命令行選項

自訂命令行選項允許開發者進一步自訂和控制服務的行為。

環境感知能力

不論是生產伺服器、測試環境還是開發系統，Topshelf都能識別並適應其環境。

對依賴注入的支持

當與依賴注入框架一起使用時，Topshelf提高了軟體架構的質量，並使得管理服務依賴更容易。

跨平台能力

Topshelf主要為Windows設計，但當利用.NET Core時，其也可以在Linux和macOS上執行服務，從而提高了其與其他操作系統的相容性。

Create and Config 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.");
            });
        }
    }
}

Imports System
Imports Topshelf

Namespace MyWindowsService
	' Define a simple service class with Start and Stop methods
	Public Class MyService
		Public Function Start() As Boolean
			' Service start logic
			Console.WriteLine("Service Started.")
			Return True
		End Function

		Public Function [Stop]() As Boolean
			' Service stop logic
			Console.WriteLine("Service Stopped.")
			Return True
		End Function
	End Class

	' Main program class to run the Topshelf service
	Friend Class Program
		Shared Sub Main(ByVal args() As String)
			HostFactory.Run(Sub(x)
				' Configure the service
				x.Service(Of MyService)(Sub(s)
					s.ConstructUsing(Function(name) New MyService())
					s.WhenStarted(Function(tc) tc.Start())
					s.WhenStopped(Function(tc) tc.Stop())
				End Sub)

				' 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.")
			End Sub)
		End Sub
	End Class
End Namespace

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易於整合且有豐富的文件，開發者可以輕鬆地將其整合到他們的程式中。 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.");
            });
        }
    }
}

Imports System
Imports IronPdf
Imports Topshelf

Namespace PdfService
	' Define a service class with PDF generation logic
	Public Class MyPdfService
		Public Function Start() As Boolean
			Console.WriteLine("Service Starting...")
			GeneratePdf()
			Return True
		End Function

		Public Function [Stop]() As Boolean
			Console.WriteLine("Service Stopping...")
			Return True
		End Function

		' Method to generate a PDF using IronPDF
		Private Sub GeneratePdf()
			Dim renderer = New HtmlToPdf()
			Dim pdf = renderer.RenderHtmlAsPdf("<h1>Hello, PDF!</h1>")
			pdf.SaveAs("GeneratedDocument.pdf")
			Console.WriteLine("PDF Generated.")
		End Sub
	End Class

	' Main program to configure and run the service using Topshelf
	Friend Class Program
		Shared Sub Main(ByVal args() As String)
			HostFactory.Run(Sub(x)
				x.Service(Of MyPdfService)(Sub(s)
					s.ConstructUsing(Function(name) New MyPdfService())
					s.WhenStarted(Function(tc) tc.Start())
					s.WhenStopped(Function(tc) tc.Stop())
				End Sub)

				x.RunAsLocalSystem()
				x.SetServiceName("MyPdfService")
				x.SetDisplayName("My PDF Service")
				x.SetDescription("A service that generates PDF files using IronPDF and Topshelf.")
			End Sub)
		End Sub
	End Class
End Namespace

開發者可以藉由將Topshelf與IronPDF在C#中結合，快速設計強大的Windows服務以生成和操控PDF文件。 Topshelf提供流暢且使用者友好的API，使得設置和管理Windows服務變得更加容易。

一個Stop）該服務的方法，將服務邏輯封裝於所給範例中。 IronPDF用於Start方法中，從HTML文字中建立一個簡單的PDF文件 使用HTML。 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的挑戰過程。 這種整合在C#中將Topshelf和IronPDF的組合能力集合起來，適用於需要自動化文件建立或修改的應用程式。 它提供了可靠性和便於維護性。