依赖注入

服务生存期

可以使用以下任一生存期注册服务：

暂时
作用域
单例

暂时

暂时生存期服务是每次从服务容器进行请求时创建的。这种生存期适合轻量级、无状态的服务。向 AddTransient 注册暂时性服务。

在处理请求的应用中，在请求结束时会释放暂时服务。

即使同一个请求获取多次也会是不同的实例

作用域

作用域生存期服务针对每个客户端请求（连接）创建一次。向 AddScoped 注册范围内服务。

在处理请求的应用中，在请求结束时会释放有作用域的服务。和暂时生存期服务一样

同一个请求获取多次会得到相同的实例

使用 Entity Framework Core 时，默认情况下 AddDbContext 扩展方法使用范围内生存期来注册 DbContext 类型。

不要从单一实例解析范围内服务。当处理后续请求时，它可能会导致服务处于不正确的状态。可以：

从范围内或暂时性服务解析单一实例服务。
从其他范围内或暂时性服务解析范围内服务。

默认情况下在开发环境中，从具有较长生存期的其他服务解析服务将引发异常。

要在中间件中使用范围内服务，请使用以下方法之一：

将服务注入中间件的 Invoke 或 InvokeAsync 方法。使用构造函数注入会引发运行时异常，因为它强制使范围内服务的行为与单一实例类似。
使用基于工厂的中间件。使用此方法注册的中间件按客户端请求（连接）激活，这也使范围内服务可注入中间件的 InvokeAsync 方法。

public async Task InvokeAsync(HttpContext context,
    IOperationScoped scopedOperation)
{
    _logger.LogInformation("Transient: " + _transientOperation.OperationId);
    _logger.LogInformation("Scoped: "    + scopedOperation.OperationId);
    _logger.LogInformation("Singleton: " + _singletonOperation.OperationId);

    await _next(context);
}

单例

创建单例生命周期服务的情况如下：

在首次请求它们时进行创建；或者
在向容器直接提供实现实例时由开发人员进行创建。很少用到此方法。

每个后续请求都使用相同的实例。如果应用需要单一实例行为，则允许服务容器管理服务的生存期。不要实现单一实例设计模式，或提供代码来释放单一实例。服务永远不应由解析容器服务的代码释放。如果类型或工厂注册为单一实例，则容器自动释放单一实例。

向 AddSingleton 注册单一实例服务。单一实例服务必须是线程安全的，并且通常在无状态服务中使用。

在处理请求的应用中，当应用关闭并释放 ServiceProvider 时，会释放单一实例服务。由于应用关闭之前不释放内存，因此请考虑单一实例服务的内存使用。

服务注册方法

框架提供了适用于特定场景的服务注册扩展方法：

服务注册方法
方法	自动对象释放	多种实现	传递参数
`Add{LIFETIME}<{SERVICE}, {IMPLEMENTATION}>()` 示例： `services.AddSingleton<IMyDep, MyDep>();`	“是”	是	否
`Add{LIFETIME}<{SERVICE}>(sp => new {IMPLEMENTATION})` 示例： `services.AddSingleton<IMyDep>(sp => new MyDep());` `services.AddSingleton<IMyDep>(sp => new MyDep(99));`	是	是	是
`Add{LIFETIME}<{IMPLEMENTATION}>()` 示例： `services.AddSingleton<MyDep>();`	是	否	否
`AddSingleton<{SERVICE}>(new {IMPLEMENTATION})` 示例： `services.AddSingleton<IMyDep>(new MyDep());` `services.AddSingleton<IMyDep>(new MyDep(99));`	否	是	是
`AddSingleton(new {IMPLEMENTATION})` 示例： `services.AddSingleton(new MyDep());` `services.AddSingleton(new MyDep(99));`	否	否	是

从 main 调用服务

使用 IServiceScopeFactory.CreateScope 创建 IServiceScope 以解析应用范围内的作用域服务。此方法可以用于在启动时访问有作用域的服务以便运行初始化任务。

public class Program
{
    public static void Main(string[] args)
    {
        var host = CreateHostBuilder(args).Build();

        using (var serviceScope = host.Services.CreateScope())
        {
            var services = serviceScope.ServiceProvider;

            try
            {
                var myDependency = services.GetRequiredService<IMyDependency>();
                myDependency.WriteMessage("Call services from main");
            }
            catch (Exception ex)
            {
                var logger = services.GetRequiredService<ILogger<Program>>();
                logger.LogError(ex, "An error occurred.");
            }
        }

        host.Run();
    }

    public static IHostBuilder CreateHostBuilder(string[] args) =>
        Host.CreateDefaultBuilder(args)
            .ConfigureWebHostDefaults(webBuilder =>
            {
                webBuilder.UseStartup<Startup>();
            });
}

避免在 ConfigureServices 中调用 BuildServiceProvider。正确方法是使用选项模式对 DI 的内置支持：

public void ConfigureServices(IServiceCollection services)
{
    services.AddAuthentication(CookieAuthenticationDefaults.AuthenticationScheme)
        .AddCookie();

    services.AddOptions<CookieAuthenticationOptions>(
                        CookieAuthenticationDefaults.AuthenticationScheme)
        .Configure<IMyService>((options, myService) =>
        {
            options.LoginPath = myService.GetLoginPath();
        });

    services.AddRazorPages();
}