信息发布→ 登录 注册 退出

.NET如何创建一个Windows服务

发布时间:2025-11-01

点击量:
首先创建.NET控制台项目并安装Microsoft.Extensions.Hosting.WindowsServices包,接着继承BackgroundService编写服务逻辑,在Program.cs中通过AddWindowsService配置服务宿主,发布后使用sc命令安装为系统服务,建议开发时以控制台模式调试,最终部署需注意路径与权限问题。

创建一个 .NET 的 Windows 服务并不复杂,但需要正确配置项目类型、服务逻辑和安装机制。以下是以 .NET(.NET 5+ 或 .NET Core)为例,在 Visual Studio 中创建 Windows 服务的完整步骤。

1. 创建 .NET 控制台项目

Windows 服务本质上是一个后台运行的控制台应用,不会显示 UI。你需要从控制台项目开始:

  • 打开 Visual Studio,选择“创建新项目”。
  • 选择“控制台应用 (.NET)”模板,语言选 C#。
  • 设置项目名称(如 MyWindowsService),选择目标框架(如 .NET 6 或更高)。

2. 安装必要的 NuGet 包

.NET 本身不默认支持 Windows 服务宿主,需添加以下包:

  • Microsoft.Extensions.Hosting.WindowsServices:提供 Windows 服务集成支持。

在项目上右键 → “管理 NuGet 包” → 搜索并安装该包。

3. 编写服务逻辑(继承 BackgroundService)

创建一个类继承 BackgroundService,实现后台任务逻辑

public class MyWorker : BackgroundService
{
private readonly ILogger _logger;

public MyWorker(ILogger logger)
{
_logger = logger;
}

protected override async Task ExecuteAsync(CancellationToken stoppingToken)
{
while (!stoppingToken.IsCancellationRequested)
{
_logger.LogInformation("MyWorker 正在运行:{time}", DateTime.Now);
await Task.Delay(1000, stoppingToken); // 每秒执行一次
}
}
}

4. 配置 Program.cs 以支持 Windows 服务

修改 Program.cs,使用 UseWindowsService() 启用服务模式:

using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Hosting;

var builder = Host.CreateApplicationBuilder(args);
builder.Services.AddWindowsService();
builder.Services.AddHostedService();

// 可选:添加日志输出到文件或事件日志
builder.Logging.AddEventLog(settings =>
{
settings.SourceName = "MyWindowsService";
});

var host = builder.Build();
host.Run();

调用 AddWindowsService() 后,应用会自动检测是否以服务方式运行,并适配生命周期。

5. 发布和安装服务

完成开发后,需将应用发布并注册为系统服务:

  • 发布应用:右键项目 → “发布” → 选择文件夹发布,生成可执行文件(如 MyWindowsService.exe)。
  • 以管理员身份打开命令提示符,运行以下命令安装服务:
sc create "MyWindowsService" binPath= "C:\path\to\MyWindowsService.exe" start= auto

其中 start= auto 表示开机自启,也可设为 demanded 手动启动。

常用命令:

  • 启动服务:sc start MyWindowsService
  • 停止服务:sc stop MyWindowsService
  • 删除服务:sc delete MyWindowsService

6. 调试与日志建议

直接调试服务较困难,推荐:

  • 开发阶段可在 Program.cs 中判断是否以服务运行,否则作为普通控制台运行:
#if DEBUG
host.Run(); // 直接运行便于调试
#else
host.RunAsService();
#endif

或使用日志记录(如写入文件或 Windows 事件日志)来跟踪服务行为。

基本上就这些。只要项目配置正确,.NET 的 Windows 服务开发就很顺畅。关键是理解它依赖宿主模型,而不是传统 WinForms 那种服务模板。部署时注意权限和路径问题,避免启动失败。

标签:# 并安装  # protected  # var  # delete  # 事件  # visual studio  # ui  # 右键  # 创建一个  # private  # 是一个  # 设为  # 也可  # 可在  # 可选  # 为例  # 本质上  # .net  # public  # class  # using  # 继承  # auto  # Logging  # while  # if  # c#  # nas  # microsoft  # win  # ai  # app  # windows  
在线客服
服务热线

服务热线

4008888355

微信咨询
二维码
返回顶部
×二维码

截屏,微信识别二维码

打开微信

微信号已复制,请打开微信添加咨询详情!