创建一个 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.cs 文件中实现你的业务逻辑:
public class Worker : BackgroundService
{
private readonly ILogger
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();
await host.RunAsync();
这样,当应用以服务方式运行时,会自动识别并注册为 Windows 服务。
发布与部署服务
完成开发后,发布项目并部署为服务:
右键项目 → “发布” → 选择文件夹发布路径(如 C:\MyServices\MyWinService) 使用 sc 命令行工具安装服务:sc create MySampleWinService binPath="C:\MyServices\MyWinService\MyWinService.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 服务变得简单可控。
