C# 怎么在 ASP.NET Core 中实现依赖注入_C# ASP.NET Core 依赖注入实战教程

来源:这里教程网 时间:2026-02-21 17:30:16 作者:

在 ASP.NET Core 中,依赖注入(Dependency Injection, DI)是框架内置的核心功能之一。它帮助开发者实现松耦合、可测试和可维护的代码结构。下面通过实际示例说明如何在 C# 的 ASP.NET Core 项目中正确使用依赖注入。

什么是依赖注入

依赖注入是一种设计模式,用于将对象的创建和使用分离。类不再自己创建依赖项,而是由外部容器“注入”所需的服务。ASP.NET Core 内置了一个轻量级的服务容器,可以自动管理服务的生命周期并注入到控制器、中间件或其他服务中。

注册服务到依赖注入容器

Program.cs 文件中,你可以通过

builder.Services
将服务添加到容器中。常见的注册方式有三种:

Scoped:每次 HTTP 请求创建一个实例 Singleton:整个应用生命周期内只创建一个实例 Transient:每次请求服务时都创建新实例


// Program.cs
var builder = WebApplication.CreateBuilder(args);

// 添加服务到容器
builder.Services.AddScoped();
builder.Services.AddSingleton();
builder.Services.AddTransientailNotificationService>();

builder.Services.AddControllers();

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

定义接口与实现类

为了更好地使用 DI,推荐面向接口编程。例如:


public interface IUserService
{
string GetUserName(int id);
}

public class UserService : IUserService
{
public string GetUserName(int id)
{
return $"用户_{id}";
}
}

然后在控制器中直接注入:


[ApiController]
[Route("[controller]")]
public class UserController : ControllerBase
{
private readonly IUserService _userService;

public UserController(IUserService userService)  
{  
    _userService = userService;  
}  
[HttpGet("{id}")]  
public IActionResult Get(int id)  
{  
    var name = _userService.GetUserName(id);  
    return Ok(new { Id = id, Name = name });  
}  

}

服务生命周期注意事项

选择合适的生命周期很重要,错误使用可能导致内存泄漏或数据错乱:

数据库上下文通常注册为 Scoped 全局配置缓存适合用 Singleton 轻量级、无状态工具类可用 Transient

注意:不要在 Singleton 服务中注入 Scoped 或 Transient 服务,除非你手动控制其作用域,否则可能引发意外行为。

从容器中获取服务(不推荐常规使用)

大多数情况下应通过构造函数注入。但在某些场景(如中间件、静态上下文),可以使用服务提供者:


using (var scope = app.Services.CreateScope())
{
var userService = scope.ServiceProvider.GetService();
var name = userService?.GetUserName(1);
}

基本上就这些。掌握好依赖注入,能让你的 ASP.NET Core 应用更清晰、更易扩展。

相关推荐