VS 中创建并安装.NET Framework Windows 服务教程

Windows 服务(Windows Service)是可以在后台长期运行的应用程序,以下是基于 Visual Studio 创建并安装.NET Framework 版本 Windows 服务的完整步骤:
一、创建 Windows 服务项目

复制代码
打开 Visual Studio(建议使用 2019/2022 版本),新建项目,搜索并选择「Windows 服务(.NET Framework)」模板,确认.NET Framework 版本(推荐 4.6 及以上)后创建项目。
项目创建完成后,会自动生成一个服务类文件(默认名称如Service1.cs),右键该文件选择「查看代码」,进入代码编辑界面。
该类中默认包含两个核心事件方法:
    OnStart:服务启动时触发,可在此编写服务运行的核心业务逻辑(如定时任务、监听端口等);
    OnStop:服务停止时触发,可在此编写资源释放逻辑(如关闭数据库连接、停止线程等)。

二、编译并安装服务

复制代码
编写完业务逻辑后,右键项目选择「生成」(或按 F6),生成完成后找到编译输出路径:
    调试模式(Debug):项目目录 \bin\Debug;
    发布模式(Release):项目目录 \bin\Release(生产环境建议用此模式)。
以管理员身份打开 CMD 命令提示符(关键!普通权限会导致安装失败),导航到编译输出路径:
bash
运行

# 示例路径,替换为你的实际路径
cd /d D:\Test\Test.Host\bin\Debug

执行安装命令(需匹配.NET Framework 版本和系统位数):
bash
运行

# 64位系统 + .NET Framework 4.x
C:\Windows\Microsoft.NET\Framework64\v4.0.30319\InstallUtil.exe TestService.exe

# 32位系统 + .NET Framework 4.x(若适用)
# C:\Windows\Microsoft.NET\Framework\v4.0.30319\InstallUtil.exe TestService.exe

安装成功后,打开 Windows 服务管理器验证:
    方式 1:按下Win + R,输入services.msc回车;
    方式 2:控制面板 → 管理工具 → 服务。
    在服务列表中即可找到你安装的服务(默认名称为项目中设置的服务名),可手动启动 / 停止服务。

三、补充实用说明

复制代码
卸载服务:若想卸载服务,先执行卸载命令:
bash
运行

C:\Windows\Microsoft.NET\Framework64\v4.0.30319\InstallUtil.exe /u TestService.exe

更新服务:先停止你的服务运行,然后在vs中去重新编译,最后在服务中重启启动即可,不需要卸载服务后重新安装;

服务命名:建议在创建服务时修改默认服务名(在服务类的设计视图中,右键→属性,设置「ServiceName」),避免与系统服务重名。
调试技巧:直接安装服务调试不便,可在Main方法中临时添加控制台输出逻辑,先以控制台程序运行调试,确认逻辑无误后再安装为服务。

总结

复制代码
核心关键点:编写 Windows 服务的业务逻辑需放在OnStart/OnStop方法中,这是服务启动 / 停止的入口;
安装必备条件:必须以管理员身份运行 CMD,否则会因权限不足导致安装失败;
路径注意事项:InstallUtil.exe的路径需匹配系统位数(Framework/Framework64)和.NET Framework 版本,避免路径错误。

关键点回顾

复制代码
编辑服务逻辑的核心是重写OnStart(启动)和OnStop(停止)方法;
安装服务时 CMD 必须以管理员身份运行,且需使用对应版本的InstallUtil.exe;
记得通过services.msc验证服务安装结果,卸载服务需加/u参数。
相关推荐
rockey6276 小时前
AScript如何实现中文脚本引擎
c#·.net·script·eval·expression·function·动态脚本
航Hang*7 小时前
Windows Server 配置与管理——第3章:文件系统管理
运维·服务器·windows·vmware
我是唐青枫8 小时前
C#.NET gRPC 深入解析:Proto 定义、流式调用与服务间通信取舍
开发语言·c#·.net
无限进步_8 小时前
【C++】电话号码的字母组合:从有限处理到通用解法
开发语言·c++·ide·windows·git·github·visual studio
私人珍藏库9 小时前
【Windows】PDF超能助手(1.0.13)
windows·pdf·工具·软件·多功能
仟人斩9 小时前
Windows 下把 VSCode 加入右键菜单(注册表方案)
windows·vscode·上下文菜单
昵称暂无19 小时前
.NET 高级开发 | i18n 原理、实现一个 i18n 框架
javascript·c#·.net
大强同学9 小时前
对比 VS Code:Zed 编辑器编码体验全面解析
人工智能·windows·编辑器·ai编程
我是唐青枫10 小时前
C#.NET Monitor 与 Mutex 深入解析:进程内同步、跨进程互斥与使用边界
开发语言·c#·.net
李树健12311 小时前
.NET 高级开发 | .NET 中的序列化和反序列化
.net