| title | Dependency injection into controllers in ASP.NET Core |
|---|---|
| ai-usage | ai-assisted |
| author | ardalis |
| description | Discover how ASP.NET Core MVC controllers request their dependencies explicitly via their constructors with dependency injection in ASP.NET Core. |
| ms.author | tdykstra |
| ms.date | 03/04/2026 |
| uid | mvc/controllers/dependency-injection |
:::moniker range=">= aspnetcore-8.0"
ASP.NET Core MVC controllers request dependencies explicitly via constructors. ASP.NET Core has built-in support for dependency injection (DI). DI makes apps easier to test and maintain.
View or download sample code (how to download)
Services are added as a constructor parameter, and the runtime resolves the service from the service container. Services are typically defined using interfaces. For example, consider an app that requires the current time. The following interface exposes the IDateTime service:
The following code implements the IDateTime interface:
Add the service to the service container:
For more information on xref:Microsoft.Extensions.DependencyInjection.ServiceCollectionServiceExtensions.AddSingleton*, see DI service lifetimes.
The following code displays a greeting to the user based on the time of day:
Run the app and a message is displayed based on the time.
The xref:Microsoft.AspNetCore.Mvc.FromServicesAttribute enables injecting a service directly into an action method without using constructor injection:
The following code shows how to access keyed services from the DI container by using the [FromKeyedServices] attribute:
:::code language="csharp" source="~/../AspNetCore.Docs.Samples/fundamentals/minimal-apis/samples/KeyServiceController/Program.cs" :::
Accessing app or configuration settings from within a controller is a common pattern. The options pattern described in xref:fundamentals/configuration/options is the preferred approach to manage settings. Generally, don't directly inject xref:Microsoft.Extensions.Configuration.IConfiguration into a controller.
Create a class that represents the options. For example:
Add the configuration class to the services collection:
Configure the app to read the settings from a JSON-formatted file:
The following code requests the IOptions<SampleWebSettings> settings from the service container and uses them in the Index method:
By default, ASP.NET Core doesn't register controllers as services in the DI container. The runtime uses the DefaultControllerActivator to create controller instances and resolves services from the DI container for constructor parameters, but the controller itself isn't resolved from the container.
Calling AddControllersAsServices registers all controllers as services in the DI container:
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddControllersWithViews().AddControllersAsServices();Registering controllers as services enables:
- Intercepting controller creation with a custom
IControllerActivator. - Using any DI lifetime management for controllers.
- Injecting services into controllers using any registered constructor, since the DI container selects the constructor.
Note
Configure the ApplicationPartManager before calling AddControllersAsServices. See xref:mvc/extensibility/app-parts#prevent-loading-resources for details.
- See xref:mvc/controllers/testing to learn how to make code easier to test by explicitly requesting dependencies in controllers.
- Keyed service dependency injection container support
- Replace the default dependency injection container with a third party implementation.
:::moniker-end