【C# / ASP.NET Core】AddSingleton・AddScoped・AddTransientの違いを徹底解説

ASP.NET Coreでは、Startup.cs（.NET 6以降ではProgram.cs）に依存関係（DIサービス）を登録する方法が3つあります。それが「AddSingleton」「AddScoped」「AddTransient」です。

これらはいずれも依存性注入（Dependency Injection）のためのメソッドですが、インスタンスの生存期間（ライフタイム）がそれぞれ異なります。適切に使い分けることで、アプリケーションのパフォーマンスや安定性に大きな影響を与えます。

AddSingleton（シングルトン）とは

型をシングルトンとして登録すると、アプリケーション全体でただ1つのインスタンスが共有されます。すべてのリクエスト、すべてのユーザーに対して同じインスタンスが使用されるため、静的オブジェクトを持つのに近いイメージです。

インスタンスは最初のリクエスト時に生成され、以降はアプリケーションがシャットダウンするまで同じインスタンスが再利用され続けます。

public void ConfigureServices(IServiceCollection services)
{
    services.AddSingleton<ILog, Logger>();
}

AddScoped（スコープ）とは

型をスコープとして登録すると、1つのHTTPリクエストごとに1つのインスタンスが生成されます。同じリクエスト内であれば同じインスタンスが共有され、新しいリクエストが来るたびに新しいインスタンスが作られます。

リクエスト単位で状態を管理したい場合に適しており、Entity Framework CoreのDbContextなどでよく使われるライフタイムです。

public void ConfigureServices(IServiceCollection services)
{
    services.AddScoped<ILog, Logger>();
}

AddTransient（トランジェント）とは

型をトランジェントとして登録すると、解決されるたびに毎回新しいインスタンスが生成されます。サービスやコントローラーごと、リクエストごと、ユーザーごとに、常にまったく新しいインスタンスが作られます。

public void ConfigureServices(IServiceCollection services)
{
    services.AddTransient<ILog, Logger>();
}

3つのライフタイム比較表