.NET如何创建一个Windows服务

浅墨君_3118

浅墨君_3118

2025-11-01

701人浏览

原创

首先创建.net控制台项目并安装microsoft.extensions.hosting.windowsservices包,接着继承backgroundservice编写服务逻辑,在program.cs中通过addwindowsservice配置服务宿主,发布后使用sc命令安装为系统服务,建议开发时以控制台模式调试,最终部署需注意路径与权限问题。

.net如何创建一个windows服务

创建一个 .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() 后,应用会自动检测是否以服务方式运行,并适配生命周期。

windows-healing-gateway
windows-healing-gateway

通过任务计划程序自动监控并自修复 Windows 上的 OpenClaw Gateway,具备 AI 诊断和 Telegram 报警功能。

下载

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 那种服务模板。部署时注意权限和路径问题,避免启动失败。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

windows microsoft c#

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
while的用法
while的用法

while的用法是“while 条件: 代码块”,条件是一个表达式,当条件为真时,执行代码块,然后再次判断条件是否为真,如果为真则继续执行代码块,直到条件为假为止。本专题为大家提供while相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.25

334

5

class在c语言中的意思
class在c语言中的意思

在C语言中,"class" 是一个关键字,用于定义一个类。想了解更多class的相关内容,可以阅读本专题下面的文章。

2024.01.03

3056

7

python中class的含义
python中class的含义

本专题整合了python中class的相关内容,阅读专题下面的文章了解更多详细内容。

2025.12.06

286

9

数据库Delete用法
数据库Delete用法

数据库Delete用法:1、删除单条记录;2、删除多条记录;3、删除所有记录;4、删除特定条件的记录。更多关于数据库Delete的内容,大家可以访问下面的文章。

2023.11.13

2331

4

drop和delete的区别
drop和delete的区别

drop和delete的区别:1、功能与用途;2、操作对象;3、可逆性;4、空间释放;5、执行速度与效率;6、与其他命令的交互;7、影响的持久性;8、语法和执行;9、触发器与约束;10、事务处理。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.12.29

745

3

windows查看端口占用情况
windows查看端口占用情况

Windows端口可以认为是计算机与外界通讯交流的出入口。逻辑意义上的端口一般是指TCP/IP协议中的端口,端口号的范围从0到65535,比如用于浏览网页服务的80端口,用于FTP服务的21端口等等。怎么查看windows端口占用情况呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.07.26

2979

3

查看端口占用情况windows
查看端口占用情况windows

端口占用是指与端口关联的软件占用端口而使得其他应用程序无法使用这些端口,端口占用问题是计算机系统编程领域的一个常见问题,端口占用的根本原因可能是操作系统的一些错误,服务器也可能会出现端口占用问题。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.07.27

2538

6

windows照片无法显示
windows照片无法显示

当我们尝试打开一张图片时,可能会出现一个错误提示,提示说"Windows照片查看器无法显示此图片,因为计算机上的可用内存不足",本专题为大家提供windows照片无法显示相关的文章,帮助大家解决该问题。

2023.08.01

1408

3

windows查看端口被占用的情况
windows查看端口被占用的情况

windows查看端口被占用的情况的方法:1、使用Windows自带的资源监视器;2、使用命令提示符查看端口信息;3、使用任务管理器查看占用端口的进程。本专题为大家提供windows查看端口被占用的情况的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

2319

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
C# 教程
C# 教程

共94课时 | 21.6万人学习

python编程入门系列图文教程
python编程入门系列图文教程

共65课时 | 27.1万人学习

vscode其实很简单
vscode其实很简单

共72课时 | 32.1万人学习