C#的IHostedService是什么？如何创建在后台运行的服务？-C#.Net教程-PHP中文网

C#的IHostedService是什么？如何创建在后台运行的服务？

星降

发布： 2025-11-22 15:37:02

原创

380人浏览过

使用 IHostedService 创建后台服务需实现接口或继承 BackgroundService 类，1. 实现 StartAsync 和 StopAsync 方法启动和停止任务，2. 在 Program.cs 中通过 AddHostedService 注册服务，推荐继承 BackgroundService 并重写 ExecuteAsync 执行循环逻辑，同时监听 CancellationToken 确保优雅关闭。

c#的ihostedservice是什么？如何创建在后台运行的服务？

IHostedService 是 C# 中用于在 .NET 应用程序（特别是 ASP.NET Core 和泛型主机应用）中运行后台任务的接口。它允许你在应用程序启动后执行长时间运行或周期性执行的操作，比如定时处理数据、轮询数据库、发送邮件、监听消息队列等。

实现 IHostedService 接口后，你的服务会在应用启动时自动开始，并在应用关闭时优雅地停止。

如何使用 IHostedService 创建后台服务？

要创建一个后台运行的服务，你需要：

1. 实现 IHostedService 接口

该接口包含两个方法：

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

下面是一个简单的后台服务示例，每 5 秒打印一次时间：

using Microsoft.Extensions.Hosting;
using System.Threading;
using System.Threading.Tasks;

public class MyBackgroundService : IHostedService
{
    private Timer? _timer;

    public Task StartAsync(CancellationToken cancellationToken)
    {
        _timer = new Timer(DoWork, null, TimeSpan.Zero, TimeSpan.FromSeconds(5));
        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;
    }
}

登录后复制

2. 将服务注册到依赖注入容器

网亚NET!B2C商城系统

网亚Net!B2C商城系统,是创想商务拥有独立产权自主开发,基于WEB应用的B/S架构B2C网上商城系统，主要面向企业或个人构建单用户商城提供友好的解决方案，最大化满足客户目前及今后的独立商城应用需求。该系统运行于微软公司的.NET 平台，采用ASP.NET 3.x技术进行分层开发。特色功能如下1、一键式的在线安装操作；2、完善的标签模板技术；3、静态HTML页面生成；4、自主SEO优化推广；5、

查看详情

在 Program.cs 或 Startup.cs 中将你的服务添加为托管服务：

var builder = WebApplication.CreateBuilder(args);

// 添加后台服务
builder.Services.AddHostedService<MyBackgroundService>();

var app = builder.Build();
app.Run();

登录后复制

更推荐的方式：继承 BackgroundService 类

.NET 提供了一个抽象类 BackgroundService，它是 IHostedService 的实现，更适合复杂的异步后台任务。

它提供了一个虚方法 ExecuteAsync，你可以重写它来定义主逻辑。

using Microsoft.Extensions.Hosting;
using System.Threading;
using System.Threading.Tasks;

public class TimedBackgroundService : BackgroundService
{
    protected override async Task ExecuteAsync(CancellationToken stoppingToken)
    {
        while (!stoppingToken.IsCancellationRequested)
        {
            // 执行任务
            Console.WriteLine($"定时任务执行: {DateTime.Now}");

            // 等待 5 秒，期间可被取消
            await Task.Delay(TimeSpan.FromSeconds(5), stoppingToken);
        }
    }
}

登录后复制

同样需要注册：

```csharp builder.Services.AddHostedService(); ```