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

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

星降

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

原创

300人浏览过

使用 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. 将服务注册到依赖注入容器

牛NIUCMS本地O2O系统

牛NIUCMS本地O2O系统是一个以php+mysql进行开发的o2o网站系统。NIUCMS是一款强大的网站管理系统。支持智慧城市、智慧小区、智慧乡村、本地生活门户、本地O2O平台的构建。请注意以下几点：1、这套源码必须要服务器支持伪静态，是支持.htaccess规则的伪静态，一般Apache服务器支持，别搞的下载回去以后说什么缺少文件，其实源码并非缺少文件。2、这套源码请在php 5.4环境下

查看详情

在 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(); ```