オープンソースプロジェクトのTopshelf .NETパッケージは、Windowsサービスの開発、セットアップ、および実装を簡略化します。 Windowsサービスの作成のプロセスから多くの複雑さを排除することで、開発者はWindowsサービス管理の細部ではなくアプリケーションの重要な機能に集中できます。

Topshelfは、少ないコード変更でコンソールアプリをサービスに変換するのを簡単に行えます。 また、依存関係やリカバリオプション、サービスの開始と停止のアクションを含むサービス設定を確立するための流動的なAPIを提供します。 .NET開発者が安定で管理しやすいWindowsサービスを効果的に作成しようとする際、Topshelfは使いやすさと適応性から人気があります。

Topshelfが提供する多くの機能は、.NETでWindowsサービスを設計および維持するのを簡単にします。 ここにその顕著な属性のいくつかがあります。

使いやすさ

Topshelfは、Windowsサービスの設定と管理のプロセスを簡素化する基本的で流動的なAPIを提供します。 開発者は、ほとんどコードを変更しなくてもコンソールアプリをサービスに簡単に変換できます。

設定の柔軟性

開始、停止、一時停止、および継続のアクションを含む設定オプションをサポートしています。 サービスの依存関係やサービスクラスのリカバリオプションを開発者が指定することもできます。

インストールとアンインストール

.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は、C#プログラムがPDFドキュメントを作成、読み取り、編集できる機能豊富な.NETライブラリです。 このプログラムを使用すると、開発者はHTML、CSS、JavaScriptコンテンツから印刷可能な高品質のPDFを簡単に生成できます。 PDFの分割と結合、ドキュメントへの透かしの追加、ヘッダーとフッターの追加、およびHTMLのPDFへの変換は、基本機能の一部です。 IronPDFは、.NET Frameworkと. NET Coreの両方をサポートしており、さまざまなアプリケーションに役立ちます。

PDFは統合が簡単で、豊富なドキュメントがあるため、開発者はそれを簡単にプログラムへ組み込むことができます。 IronPDFは、複雑なレイアウトやフォーマットをスムーズに処理することで、生成されたPDFがソースHTMLコンテンツを密接に再現することを保証します。

IronPDF の機能

HTMLからのPDF生成

JavaScript、HTML、CSSをPDFに変換します。 メディアクエリやレスポンシブデザインなどの現代Web標準に対応しています。 HTMLとCSSでPDFの請求書、レポート、ドキュメントを動的に装飾するのに便利です。

PDF編集

既存の PDF にテキスト、画像、およびその他のコンテンツを追加できます。 PDFファイルからテキストや画像を抽出します。 多数の PDF を 1 つのファイルに結合します。PDF ファイルを複数の個別のドキュメントに分割します。 透かし、注釈、ヘッダー、フッターを含めます。

PDF変換

Word、Excel、画像ファイルなどのさまざまなファイル形式をPDF形式に変換します。 PDFから画像（PNG、JPEG、など）への変換。

性能と信頼性

工業環境で高性能と信頼性が望まれる設計特性です。 大規模なドキュメントセットを容易に管理します。

IronPDFをインストールする

.NETプロジェクトでPDFを操作するためのツールを手に入れるために、IronPDFパッケージをインストールしてください。

Install-Package IronPdf

IronPDFを使用してサービスクラスを作成する

PDFファイルの作成と修正を行うIronPDFの機能と、クラスのサービスロジックを定義します。

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

開発者はC#でTopshelfとIronPDFを組み合わせることで、PDF生成と操作のための強力なWindowsサービスを迅速に設計できます。 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の生成のような困難なプロセスを容易に管理する方法を示しています。 C#でTopshelfとIronPDFを組み合わせたこの統合は、自動化されたドキュメント作成や変更が必要なアプリケーションに最適です。 それは信頼性と保守の容易さを提供します。