0

0

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

星降

星降

发布时间:2025-11-09 17:58:02

|

896人浏览过

|

来源于php中文网

原创

答案:使用.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.cs 文件中实现你的业务逻辑:

public class Worker : BackgroundService
{
private readonly ILogger _logger;

public Worker(ILogger 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();

Sapling AI Content Detector
Sapling AI Content Detector

Sapling.ai推出的免费在线AI内容检测工具

下载

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 服务变得简单可控。

相关专题

更多
string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

311

2023.08.02

if什么意思
if什么意思

if的意思是“如果”的条件。它是一个用于引导条件语句的关键词,用于根据特定条件的真假情况来执行不同的代码块。本专题提供if什么意思的相关文章,供大家免费阅读。

698

2023.08.22

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

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

452

2024.01.03

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

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

6

2025.12.06

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

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

264

2023.11.13

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

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

204

2023.12.29

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

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

487

2023.07.26

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

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

1023

2023.07.27

苹果官网入口直接访问
苹果官网入口直接访问

苹果官网直接访问入口是https://www.apple.com/cn/,该页面具备0.8秒首屏渲染、HTTP/3与Brotli加速、WebP+AVIF双格式图片、免登录浏览全参数等特性。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

10

2025.12.24

热门下载

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

精品课程

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

共94课时 | 5.2万人学习

C 教程
C 教程

共75课时 | 3.6万人学习

C++教程
C++教程

共115课时 | 9.8万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号