IHostedService用于在.NET应用中运行后台任务，通过实现StartAsync和StopAsync方法管理服务生命周期。示例中创建TimedBackgroundService类，利用Timer每10秒执行一次任务，并在Program.cs中通过AddHostedService注册。适用于轮询、消息监听等场景，需注意异步处理、取消令牌和异常捕获，确保任务稳定运行。
.NET中的IHostedService是一个用于实现后台任务的接口，允许你在应用程序启动和关闭时运行长时间运行的逻辑。它非常适合处理轮询、消息监听、定时任务或任何需要在应用生命周期内持续运行的操作。
理解 IHostedService 接口
IHostedService定义了两个方法：
- StartAsync(CancellationToken cancellationToken)：在应用主机启动后调用，用于开始后台操作。
- StopAsync(CancellationToken cancellationToken)：在应用关闭时调用，用于优雅地停止后台任务。
你可以注册多个实现了该接口的服务，它们会随应用生命周期自动管理。
创建一个长时间运行的后台服务
下面是一个简单的示例，展示如何创建一个每10秒打印当前时间的后台服务。
1. 创建后台服务类
新建一个类，例如 TimedBackgroundService，并实现 IHostedService：
outlook-microsoft
下载
微软 Outlook 邮箱和日历管理工具（支持世纪互联版 Office 365）。用于查看、发送、搜索邮件，管理日历日程，创建会议，查询忙闲状态。注意：此功能仅支持世纪互联（21Vianet）版 Microsoft 365，使用 login.chinacloudapi.cn。
using Microsoft.Extensions.Hosting;
using System.Threading;
using System.Threading.Tasks;
public class TimedBackgroundService : IHostedService, IDisposable
{
private Timer? _timer;
public Task StartAsync(CancellationToken cancellationToken)
{
// 启动定时器，每10秒执行一次
_timer = new Timer(DoWork, null, TimeSpan.Zero, TimeSpan.FromSeconds(10));
return Task.CompletedTask;
}
private void DoWork(object? state)
{
// 这里写你的后台逻辑
Console.WriteLine($"后台任务执行: {DateTime.Now}");
}
public Task StopAsync(CancellationToken cancellationToken)
{
// 停止定时器
_timer?.Change(Timeout.Infinite, 0);
return Task.CompletedTask;
}
public void Dispose()
{
_timer?.Dispose();
}
}2. 在 Program.cs 中注册服务
在 .NET 6+ 的最小API项目中，你需要将服务添加到依赖注入容器：
var builder = WebApplication.CreateBuilder(args); // 添加后台服务 builder.Services.AddHostedService<TimedBackgroundService>(); var app = builder.Build(); app.Run();
如果你使用的是传统的 ASP.NET Core 项目结构（Startup.cs），则在 ConfigureServices 方法中添加：
常见应用场景与注意事项
这种模式适用于以下场景：
- 定期从数据库拉取待处理任务
- 监听消息队列（如 RabbitMQ、Kafka）
- 定时清理缓存或日志文件
- 保持与外部系统的长连接
注意点：
- 避免在
StartAsync中阻塞线程，应使用异步或定时器机制。 - 始终处理取消令牌（CancellationToken），确保能优雅退出。
- 异常未捕获可能导致服务终止，建议在循环或回调中添加 try-catch。
- 若需更精确的调度，可结合
PeriodicTimer或第三方库如 Hangfire。
基本上就这些。IHostedService 提供了一种标准方式来管理后台任务，集成简单且生命周期受控。
