.NET中的后台任务(IHostedService)是什么？如何创建一个长时间运行的服务？-C#.Net教程-PHP中文网

.NET中的后台任务(IHostedService)是什么？如何创建一个长时间运行的服务？

小老鼠

发布： 2025-11-16 15:12:06

原创

727人浏览过

IHostedService用于在.NET应用中运行后台任务，通过实现StartAsync和StopAsync方法管理服务生命周期。示例中创建TimedBackgroundService类，利用Timer每10秒执行一次任务，并在Program.cs中通过AddHostedService注册。适用于轮询、消息监听等场景，需注意异步处理、取消令牌和异常捕获，确保任务稳定运行。

.net中的后台任务(ihostedservice)是什么？如何创建一个长时间运行的服务？

.NET中的IHostedService是一个用于实现后台任务的接口，允许你在应用程序启动和关闭时运行长时间运行的逻辑。它非常适合处理轮询、消息监听、定时任务或任何需要在应用生命周期内持续运行的操作。

理解 IHostedService 接口

IHostedService定义了两个方法：

StartAsync(CancellationToken cancellationToken)：在应用主机启动后调用，用于开始后台操作。
StopAsync(CancellationToken cancellationToken)：在应用关闭时调用，用于优雅地停止后台任务。

你可以注册多个实现了该接口的服务，它们会随应用生命周期自动管理。

创建一个长时间运行的后台服务

下面是一个简单的示例，展示如何创建一个每10秒打印当前时间的后台服务。

1. 创建后台服务类

新建一个类，例如 TimedBackgroundService，并实现 IHostedService：

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 方法中添加：

```csharp services.AddHostedService(); ```