C# 怎么创建一个 Windows 服务_C# Windows 服务创建与部署指南

答案:使用.net 6 Worker Service模板创建windows服务,通过添加microsoft.Extensions.Hosting.windowsServices包并配置宿主模型,实现后台任务运行;部署时用sc命令安装并设置开机自启,开发阶段可通过控制台调试,日志建议输出到文件或事件日志。

C# 怎么创建一个 Windows 服务_C# Windows 服务创建与部署指南

创建一个 Windows 服务在 C# 中并不复杂,但需要理解其运行机制和部署流程。Windows 服务是在后台运行的长期进程,适合执行定时任务、监控系统或托管长时间运行的服务逻辑。下面是一个完整的创建与部署指南。

创建 Windows 服务项目

打开 visual studio,按照以下步骤新建项目:

  • 选择“创建新项目”
  • 搜索并选择“Windows 服务 (.NET Framework)”模板(注意:目前原生 .NET/.NET Core/.NET 5+ 的 Windows 服务需手动配置,推荐使用 .NET 6 或以上版本配合 Worker Service 模板)
  • 命名项目,例如 MyWinService

如果你使用的是 .NET 6 或更高版本,建议选择“Worker Service”模板,它更适合现代 Windows 服务开发,并支持跨平台。

编写服务逻辑(以 .NET 6 Worker Service 为例)

Program.cs 中,使用内置的宿主模型来注册后台服务:

builder.Services.AddHostedService<Worker>();

Worker.cs 文件中实现你的业务逻辑:

public class Worker : BackgroundService
{
private readonly ILogger _logger;

public Worker(ILogger<Worker> logger)   {       _logger = logger;   }    protected override async Task ExecuteAsync(CancellationToken stoppingToken)   {       while (!stoppingToken.IsCancellationRequested)       {           _logger.LogInformation("Worker running at: {time}", DateTimeOffset.Now);           await Task.Delay(1000, stoppingToken); // 每秒执行一次       }   }  

}

这个 Worker继承BackgroundService,会在服务启动时自动调用 ExecuteAsync 方法。

将应用配置为 Windows 服务

要让 .NET 应用作为 Windows 服务运行,需要添加 NuGet 包并修改宿主配置。

  • 安装 NuGet 包:Microsoft.Extensions.Hosting.WindowsServices

修改 Program.cs,启用 Windows 服务支持:

var isService = !String.IsNullOrEmpty(Environment.GetCommandLineArgs().FirstOrDefault(arg => arg.ToLower() == “–windows-service”));

var builder = Host.CreateapplicationBuilder(args);

if (isService)
{
builder.Services.AddWindowsService(options =>
{
options.ServiceName = “MySampleWinService”;
});
}
else
{
builder.Services.AddConsolelifetime();
}

builder.Services.AddHostedService();

var host = builder.Build();

C# 怎么创建一个 Windows 服务_C# Windows 服务创建与部署指南

维普科创助手

AI驱动的一站式科研资源服务平台

C# 怎么创建一个 Windows 服务_C# Windows 服务创建与部署指南 117

查看详情 C# 怎么创建一个 Windows 服务_C# Windows 服务创建与部署指南

await host.Runasync();

这样,当应用以服务方式运行时,会自动识别并注册为 Windows 服务。

发布与部署服务

完成开发后,发布项目并部署为服务:

  • 右键项目 → “发布” → 选择文件夹发布路径(如 C:MyServicesMyWinService
  • 使用 sc 命令行工具安装服务:

sc create MySampleWinService binPath=”C:MyServicesMyWinServiceMyWinService.exe —windows-service” start=auto

说明:

  • MySampleWinService 是服务名称
  • binPath 指向可执行文件,并传递 –windows-service 参数用于识别运行模式
  • start=auto 表示开机自启

启动服务:

sc start MySampleWinService

查看服务状态:

sc query MySampleWinService

卸载服务(如需):

sc delete MySampleWinService

调试与日志建议

Windows 服务无法直接调试。建议:

  • 开发阶段通过控制台运行(不传 –windows-service 参数),验证逻辑
  • 使用 ILogger 记录日志,输出到文件或 Event Log
  • 部署后检查 Windows 事件查看器中的应用程序日志

若需写入 Windows 事件日志,可添加:

builder.Logging.AddEventLog();

基本上就这些。只要结构清晰,.NET 的宿主模型让 Windows 服务变得简单可控。

上一篇
下一篇
text=ZqhQzanResources