C#的依赖注入(DI)是什么?如何在ASP.NET Core中配置和使用?

依赖注入通过将依赖实例由容器在运行时自动传入,实现解耦和控制反转。ASP.NET Core在Program.cs中通过AddSingleton、AddScoped、AddTransient注册服务,支持构造函数注入,提升代码可测试性与维护性。

依赖注入(Dependency Injection,简称DI)是C#中一种实现控制反转(IoC)的设计模式,用来解耦组件之间的依赖关系。简单来说,就是不手动创建对象,而是由框架或容器在运行时自动提供所需的依赖实例。

在ASP.NET Core中,DI被深度集成到框架中,几乎所有服务(如数据库上下文、日志、配置等)都通过DI来管理和使用。这样做让代码更灵活、可测试性更强,也更容易维护。

依赖注入的基本概念

依赖:一个类如果需要另一个类来完成工作,就称其依赖于那个类。比如一个控制器需要一个服务来处理业务逻辑,这个服务就是它的依赖。

注入:不是在类内部直接new一个依赖对象,而是在构造函数、属性或方法中接收它,由外部容器传入,这就是“注入”。

例如:

public class OrderService
{
    private readonly ILogger _logger;

    // 依赖通过构造函数注入
    public OrderService(ILogger logger)
    {
        _logger = logger;
    }
}

在ASP.NET Core中配置DI

ASP.NET Core在Program.cs中提供了统一的入口来注册服务。你可以在其中将接口和实现类添加到内置的服务容器中。

常见的注册方式有三种:

  • AddSingleton:整个应用程序生命周期内只创建一个实例
  • AddScoped:每个HTTP请求创建一个实例(适合Web应用)
  • AddTransient:每次请求依赖时都创建新实例

示例配置:

var builder = WebApplication.CreateBuilder(args);

// 注册服务
builder.Services.AddScoped();
builder.Services.AddSingleton();
builder.Services.AddTransient();

var app = builder.Build();

在控制器或中间件中使用DI

注册完成后,就可以在控制器、Razor页面、中间件甚至其他服务中通过构造函数接收依赖。

例如在控制器中使用:

[ApiController]
[Route("[controller]")]
public class OrderController : ControllerBase
{
    private readonly IOrderService _orderService;

    // 框架会自动注入已注册的服务
    public OrderController(IOrderService orderService)
    {
        _orderService = orderService;
    }

    [HttpGet]
    public IActionResult Get()
    {
        var orders = _orderService.GetAllOrders();
        return Ok(orders);
    }
}

你也可以在中间件中通过参数注入服务:

app.Use(async (context, next) =>
{
    var logger = context.RequestServices.GetService>();
    logger?.LogInformation("Request incoming");
    await next();
});

自定义服务的注册与使用建议

定义接口和实现分离,便于替换和单元测试:

public interface IEmailSender
{
    void Send(string to, string subject, string body);
}

public class SmtpEmailSender : IEmailSender { ... }

然后在Program.cs中注册:

builder.Services.AddScoped();

在需要的地方直接注入IEmailSender,无需关心具体实现。

基本上就这些。ASP.NET Core的DI机制简洁实用,掌握好注册时机和服务生命周期,就能写出结构清晰、易于扩展的应用程序。