¶ Visual Studio 2026 での、Worker Service プロジェクトについて
¶ 「ワーカーサービス」プロジェクトの作成
¶ プロジェクトテンプレートで最初から参照されているNuGetパッケージ
最初から Microsoft.Extensions.Hosting の Nuget パッケージが導入されています。
ソースジェネレーターによって、グローバル using が生成され、自動的に参照されます。
¶ プロジェクトテンプレートで最初に作られる初期PGコード
次の2ファイルのC#コードが最初から作られます。
¶ 初期PGコードの解説
¶ Generic Host
Program.cs の 3行目、Host が、モダンな .NET での Generic Host (汎用ホスト) となります。
Generic Host (汎用ホスト) では、DI (依存性の注入) コンテナや、ロギング、設定ファイルの読み書き、実行環境の切り替え、アプリのライフサイクル管理、などの機能を備えています。
常駐系のコンソールアプリ/サービスや、ASP.NET Core の Web アプリ開発の基盤となっています。
¶ Generic Host - Builder
Generic Host を構成/設定するための Builder (ビルダー) として、次の2つが用意されています。
IHostBuilder(実装:Host.CreateDefaultBuilder)
・・・ 従来の方法。メソッドチェーンできる形でコード記述して構成できる。IHostApplicationBuilder(実装:Host.CreateApplicationBuilder)
・・・ モダンな方法。デフォルトで使いやすい設定があらかじめ行われている。
Host.CreateApplicationBuilder() メソッドにより、以下の構成がデフォルトで行われます。
GetCurrentDirectory()によって返される絶対パスに、コンテンツルートを設定。- プレフィックス
DOTNET_の付いた環境変数や、コマンドライン引数から、ホスト構成を読み込む。 - 環境変数や、コマンドライン引数、
appsettings.jsonやappsettings.{Environment}.jsonから、アプリの設定を読み込む。 - コンソール、デバッグ、イベントソース、Windows イベントログの、ロギングのプロバイダーを追加。
¶ Generic Host - Build
Program.cs の 6行目 では、構成ビルダーをビルドすることで、Generic Host の ホスト IHost を生成しています。
¶ Generic Host - Run
Program.cs の 7行目 で、Generic Host アプリを起動しています。
¶ ホストされたサービスの DI (依存性の注入)
Program.cs の 4行目 では、Worker クラスを、Generic Host でホストされるサービスとして、 DI (依存性の注入)をして登録しています。
AddHostService<T>() メソッドを使うことで、ホストされたサービスとして登録することができます。
¶ BackgroundService
BackgroundService 抽象クラスは IHostedService の実装クラスで、開発者が ExecuteTask() メソッドを実装することで、処理の非同期実行と非同期終了の制御を自動で管理してくれるものです。
Worker.cs の 3行目 で、BackgroundService 抽象クラスを継承して Worker クラスを書いています。
¶ ILogger<T>
Worker.cs の 3行目 の プライマリコンストラクタ 内では、DIコンテナからロギング用のインスタンスを取り出しています。
¶ ExecuteAsync
Worker.cs の 5行目 で、BackgroundService 抽象クラスの ExecuteTask() メソッドを実装しています。
初期コードでは、プロセスがキャンセルを通知されるまでの間ずっと、1秒間に1回、現在の日時をログ出力する処理が記述されています。
¶ 初期PGの実行結果
※ Ctrl + C で、この常駐稼働プログラムを、終了させることができます。