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上执行服务，从而提高其与其他操作系统的兼容性。

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

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

通过在C#中结合使用Topshelf和IronPDF，开发人员可以快速设计出用于PDF生成和操作的强大Windows服务。 Topshelf提供了一个流畅且用户友好的API，使得设置和管理Windows服务更加容易。

在所给的示例中，一个Stop）服务的方法，并封装了服务逻辑。 在Start方法中使用IronPDF，从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#中的功能使此集成更加完美。 它提供了可靠性和易维护性。