ASP.NET Core - Accessing Configuration Settings From Appsettings.json File

Introduction

 

Keeping configurations and reading them at runtime is an essential part of any application. In a .NET Framework application, we used to have configuration values in the web.config file and read them to use throughout our application. In an ASP.NET Core application, there are many places available where we can keep our configuration values and then use them at runtime anywhere in the application. Microsoft has provided us the default providers to read configurations from such places.

 

Appsettings.json

 

In an ASP.NET core application, the "appsettings.json" file is where we can keep configurations and read them using JsonConfigurationProvider provided by Microsoft.

 

In this article, we will see how to keep configuration values in appsettings.json file and how to read those values and use them in an application.

• Read settings using IConfiguration
• Access a strongly typed value using GetValue<T> method
• Access a section using the GetSection method
• Access section and bind with strongly typed class using the Bind method
  

Source Code

 

You can get the source code from GitHub.

 

Create an Asp.Net Core web application

 

Navigate to the appsettings.json file and paste the following settings related to our application's dashboard user interface:

 

appsettings.json

"DashboardSettings": {
   "Title": "C# Corner - A Community for Software Developers",
   "Header": {
      "IsSearchBoxEnabled": true,
      "BannerTitle": "Breaking News",
      "IsBannerSliderEnabled": false
   }
}

To read settings inside any service or controller from appsettings.json file, IConfiguration service instance is required which represents a set of key/value application configuration properties. We need to inject it through construction injection to get the instance from Dependency Injection System of ASP.NET Core.

 

Note

Hierarchical settings can be accessed using keys separated by a colon (:), as shown in the below example.

 

DashboardController.cs

public class DashboardController : Controller
{
   private readonly IConfiguration configuration;

   //requires using Microsoft.Extensions.Configuration
   public DashboardController(IConfiguration configuration)
   {
      this.configuration = configuration;
   }
   public IActionResult Index()
   {
      List<object> listSettings = new List<object>();

      var dashboardTitle = configuration["DashboardSettings:Title"];
      var isSearchBoxEnabled = configuration["DashboardSettings:Header:IsSearchBoxEnabled"];
      var headerBannerTitle = configuration["DashboardSettings:Header:BannerTitle"];
      var isBannerSliderEnabled = configuration["DashboardSettings:Header:IsBannerSliderEnabled"];

      listSettings.AddRange(new object[] { dashboardTitle, isSearchBoxEnabled, headerBannerTitle, isBannerSliderEnabled });

      //requires using Newtonsoft.Json
      return Content(JsonConvert.SerializeObject(listSettings));
   }
}

Output

 

 

Accessing value strongly types using GetValue<T>

 

In the above code, we saw that the settings read as a string type only. Either they are a boolean, a number or a string. The GetValue<T> method gives access settings as strongly typed.

var dashboardTitle = configuration.GetValue<string>("DashboardSettings:Title");
var isSearchBoxEnabled = configuration.GetValue<bool>("DashboardSettings:Header:IsSearchBoxEnabled");
var headerBannerTitle = configuration.GetValue<string>("DashboardSettings:Header:BannerTitle");
var isBannerSliderEnabled = configuration.GetValue<bool>("DashboardSettings:Header:IsBannerSliderEnabled");

Output

 

 

Accessing Configuration Sections using the GetSection(key)

 

Want to read a particular section and then later on its values? Use the following code,

var headerSection = configuration.GetSection("DashboardSettings:Header");
var isSearchBoxEnabled = headerSection.GetValue<bool>("IsSearchBoxEnabled");
var headerBannerTitle = headerSection.GetValue<string>("BannerTitle");
var isBannerSliderEnabled = headerSection.GetValue<bool>("IsBannerSliderEnabled");

Output

 

 

Accessing section and bind with strongly typed class using the Bind method 

If you want to read settings and bind with a strongly typed class, then you can use the "Bind" method of IConfiguration. Using this Bind method, you can bind the given class object instance to configuration values by matching property names against configuration keys recursively.

 

This is important to note that the hierarchy of properties in class must be matched with a hierarchy of keys of the configuration section inside the appsettings.json file.

 

Create a class inside the Models folder which should have properties names similar to keys of the section you want to read.

 

DashboardSettings.cs

public class DashboardSettings
{
    public string Title { get; set; }
    public DashboardHeaderSettings Header { get; set; }
}
public class DashboardHeaderSettings
{
    public bool IsSearchBoxEnabled { get; set; }
    public string BannerTitle { get; set; }
    public bool IsBannerSliderEnabled { get; set; }
}

 

DashboardController.cs

public class DashboardController : Controller
{
    private readonly IConfiguration configuration;

    //requires using Microsoft.Extensions.Configuration
    public DashboardController(IConfiguration configuration)
    {
        this.configuration = configuration;
    }
    public IActionResult Index2()
    {
        var dashboardSettings = new DashboardSettings();
        configuration.Bind("DashboardSettings", dashboardSettings);

        //requires using Newtonsoft.Json
        return Content(JsonConvert.SerializeObject(dashboardSettings));
    }
}

In above code, we used Bind method of IConfiguration, which expects two parameters.

 

The first parameter expects "SectionName" (DashboardSettings in my case) which you want to bind. the second parameter expects an object instance to which you want to bind.

 

Output

 

 

Summary

 

In this article, we learned how to access configuration settings from the appsettings.json file in an ASP.NET a web application. In the next article, we will see an Options Pattern to read configuration settings.

 

Thanks a lot for reading. I hope you loved this article. Please share your valuable suggestions and feedbacks and write in the comment box if you have any questions.

 

Have a good day!