Dependency injection (with IOptions) in Console Apps in .NET Core 2
When you are used to building web applications, you kind of get hooked to the ease of Dependency Injection (DI) and the way settings can be specified in a JSON file and accessed through DI (IOptions<T>). It’s only logical to want the same feature is your Console app.
After reading many – many! – outdated blogs I decided to add my 50 cents specifically on a Console app. It all comes down to packages and separation of concern. Note: it feels like a bit of over-engineering, but you’ll get some nice properties in return. Your program becomes more pluggable and more testable.
First we need to right packages. And that can be quite a hassle – because the ASP.NET Core All package will include them for you – but there’s no such thing for a Console app. They might be hard to
Program vs. App
Normally the program class contains the main method and all the program-logic. If you want to do DI, it might be handy to separate the application from the setup that’s required for your DI. So I propose to build an App class that does the actual running. For argument’s sake, I’ve created such a class with a logger and some settings:
public class App
private readonly ILogger<App> _logger;
private readonly AppSettings _appSettings;
public App(IOptions<AppSettings> appSettings, ILogger<App> logger)
_logger = logger ?? throw new ArgumentNullException(nameof(logger));
_appSettings = appSettings?.Value ?? throw new ArgumentNullException(nameof(appSettings));
public async Task Run()
This basically gives us an abstracted application class that is even testable. It also gives us the opportunity to focus on setting up the application in the program class (seperating the actual application logic).
Setting up the program
In the program we’ll focus on DI. The App will also be added through DI. Not that the entry point of the program is already async so we can use await.
internal class Program
public static async Task Main(string args)
// create service collection
var services = new ServiceCollection();
// create service provider
var serviceProvider = services.BuildServiceProvider();
// entry to run app
private static void ConfigureServices(IServiceCollection services)
// add logging
// build config
var configuration = new ConfigurationBuilder()
// add services:
// add app
We’ve injected a few things:
- Logging − a lot of my application run as stand-alone services in Docker containers, so logging is key. For convenience I added a console logger. You can add any form of logging to the LoggerFactory.
- Configuration − I use a appsettings.json file in my application. It will contain a section with the app variables. The DI will auto-map it to the setting object. To make things easier I added the AddEnvironmentVariables() so I’m able to override settings in production.
- Services − this will give us nice abstractions.
The Main method will resolve the App through DI and start your program. So that’s it. Easy to use.
About the Author
Hi! I'm Kees. Thanks for checking out my Blog. I work as a .Net Engineer for one of the biggest web-shops in the Netherlands: wehkamp. I ❤️ C# and I like to solve nifty problems.Learn more