Skip to content
Branch: master
Find file History
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

Detect Config Changes With Monitor

This is a .Net Core Web Application project (API) wich demonstrates how the new .Net Core Configuration Model works when detecting and reloading configuration changes.

The default settings file and any other json file is included using .AddJsonFile() and the configuration is built using Configuration builder which is passed in from the Program to the Startup class in the way it is expected with the .Net Core 2.0.

Prior to this version the configuration was built differently with the use of ConfigurationBuilder() and UseConfiguration() through WebHost extension methods as opposed to ConfigureAppConfiguration() - which I could only figure out thanks to this StackOverflow answer.

In the example below a custom json file 'version-config.json' is included and that file is later mapped to a Strongly Typed object named VersionConfig.cs.

Previous versions of .Net Core

	public static IWebHost BuildWebHost(string[] args)
		var config = new ConfigurationBuilder()
			.AddJsonFile("version-config.json", false, true)

		return WebHost.CreateDefaultBuilder(args)

New .Net Core 2.0 or later:

	public static IWebHost BuildWebHost(string[] args)
		return WebHost.CreateDefaultBuilder(args)
			.ConfigureAppConfiguration((buiderContext, config) => {
				IHostingEnvironment env = buiderContext.HostingEnvironment;

				config.AddJsonFile("version-config.json", false, true);

The configuation is then resolved in the Startup class and controllers with the use of .Net Core built-in Dependency Injection.

In addition to this, the project uses the new IOptionsSnapshot to get the latest changes of a modified configuration.

It also makes use of IChangeToken which makes use of ChangeToken.OnChange() to hook an event if changes occur.

All together, it shows how this scenario can be achieved in the new version of .Net Core 2.0.

Just run this project hitting the Version controller. There is an API Base Controller used to enable or disabled the Monitor.


To enable the monitor, just hit the endpoint below (use stop to disable it):


After changing the version-config.json with the project running (under IISExpress by default) you will see that the changes you have made to the file can only be seen if the monitor is enabled.

So the version endpoint will only show the latest version if monitor is enabled. Obviously, this is only a demonstration and not how you would necessarily use the monitor.

If you would like to contribute by maintaining this project up to date, just drop me a message.


You can’t perform that action at this time.