Let’s dive in.<\/p>\n
<\/a>What is Configuration?<\/h2>\nApplication configuration is a way of providing the initial settings to our application on its startup<\/strong>. We use configuration to easily set up our application in different ways, usually depending on the environment that it’s deployed on.<\/p>\nConfiguration may come from multiple different sources and in a wide variety of forms<\/strong> like files, environment variables, or some kind of store like Azure Key Vault, or even from in-memory storage or as command-line arguments.<\/p>\nWhichever way(s) we choose, the configuration mechanism exists to help us create flexible applications, without the need to recompile our source code<\/strong>. By using the configuration data we determine the behavior of our applications at runtime.<\/p>\nConfiguration in .NET Core is pretty powerful and it can be easily installed and used. The NuGet package containing the configuration is Microsoft.Extensions.Configuration<\/code> and you can easily add it to any .NET Core project by typing:<\/p>\nPM> Install-Package Microsoft.Extensions.Configuration<\/code> in the Package Manager Console in Visual Studio or
\ndotnet add package Microsoft.Extensions.Configuration<\/code> if you prefer the dotnet CLI.<\/p>\nIf you create an ASP.NET Core application, you don’t have to worry about it since it’s referenced by default<\/strong>.<\/p>\nConfiguration in .NET Core is even more powerful with the use of sections, configuration providers, and the Options pattern<\/strong>. We’ll talk about all of these concepts in this article, as well as later on.<\/p>\n<\/a>How do We Define Configuration Data?<\/h2>\nConfiguration data is defined as a set of key-value pairs.<\/p>\n
Values can be:<\/p>\n
\n- integers<\/strong> – can be any integer number, used when we need a numerical value, like the maximum number of items, or a default temperature for example
\nDefaultRoomTemperature = 21<\/code><\/li>\n- booleans<\/strong> – can be true or false. Used often to determine if a behavior should be triggered or not within our application
\nTurnOnDetailedReports = true<\/code><\/li>\n- strings<\/strong> – if we need a specific string value. Typical examples, but not limited to these are connection strings and URLs
\nsqlConnection\u00a0=<\/span><\/span>\u00a0\"<\/span>server=.; database=AccountOwnerDatabase; Integrated Security=true\"<\/span><\/span><\/code><\/li>\n<\/ul>\nThese are just examples and besides a value, each key contains information about which level of the hierarchy it’s in.<\/p>\n
Let’s see what that means.<\/p>\n
<\/a>Hierarchical Data Organization and Data Flattening<\/h2>\nThe Configuration API reads the hierarchical data by flattening the structure using delimiters.<\/p>\n
This means we can write something like this in our configuration file:<\/p>\n
{\r\n\t\"Logging\": {\r\n\t\t\"LogLevel\": {\r\n\t\t\t\"Default\": \"Information\",\r\n\t\t\t\"Microsoft\": \"Warning\",\r\n\t\t\t\"Microsoft.Hosting.Lifetime\": \"Information\"\r\n\t\t}\r\n\t},\r\n\t\"AllowedHosts\": \"*\"\r\n}\r\n<\/pre>\nAnd later on, access it in our code by using the semicolon delimiter “:”.<\/p>\n
Examples:<\/p>\n
\"Logging:LogLevel:Default\"<\/code> – We can get the Default logging level
\n\"AllowedHosts\"<\/code> – We’ll get “*” (any host) in this case<\/p>\nThis means we can have multiple keys named “Default” since the organization is hierarchical.<\/p>\n
Let’s extend our example:<\/p>\n
{\r\n\t\"Logging\": {\r\n\t\t\"LogLevel\": {\r\n\t\t\t\"Default\": \"Information\",\r\n\t\t\t\"Microsoft\": \"Warning\",\r\n\t\t\t\"Microsoft.Hosting.Lifetime\": \"Information\"\r\n\t\t}\r\n\t},\r\n\t\"OtherLoggingProvider\": {\r\n\t\t\"LogLevel\": {\r\n\t\t\t\"Default\": \"Debug\"\r\n\t\t}\r\n\t},\r\n\t\"AllowedHosts\": \"*\"\r\n}<\/pre>\nNow we can access the same key within the different hierarchy:<\/p>\n
\"Logging:LogLevel:Default\"<\/code> – returns “Information”
\n\"OtherLoggingProvider:LogLevel:Default\"<\/code> – returns “Debug”<\/p>\nIf the value doesn’t exist, we’ll get a null as a result.<\/p>\n
Instead of accessing the values directly, using delimiters, we can use the options pattern<\/strong>, and GetSection()<\/code> and GetChildren()<\/code> methods to get sections and children of a section. These mechanisms make the configuration much easier to use. We’ll see how to use them later on.<\/p>\nLet’s see what we get out of the box when we create an ASP.NET Core application.<\/p>\n
<\/a>Default ASP.NET Core Configuration<\/h2>\nWhen we create a new ASP.NET Core application, our Program.cs file looks like this:<\/p>\n
public class Program\r\n{\r\n public static void Main(string[] args)\r\n {\r\n CreateHostBuilder(args).Build().Run();\r\n }\r\n\r\n public static IHostBuilder CreateHostBuilder(string[] args) =>\r\n Host.CreateDefaultBuilder(args)\r\n .ConfigureWebHostDefaults(webBuilder =>\r\n {\r\n webBuilder.UseStartup<Startup>();\r\n });\r\n}<\/pre>\nWhile it may not look that spectacular, this does a few things for us. The CreateDefaultBuilder()<\/code> method is particularly interesting to us.<\/p>\nIt creates an instance of a HostBuilder<\/code>, which implements IHostBuilder<\/code> and that’s our program initialization utility. Besides that, it populates it with some default values, some of which are the default values gathered from different sources.<\/p>\nThe CreateDefaultBuilder() method adds the default configuration values to the application in this particular order:<\/p>\n
\n- ChainedConfigurationProvider<\/strong> – adds the host<\/em>
IConfiguration<\/code> to the app<\/em> IConfiguration<\/code><\/li>\n- appsettings.json file<\/strong> – this is the default file we get when creating an ASP.NET Core template<\/li>\n
- appsettings.{EnvironmentName}.json files<\/strong> – for the environment-specific overrides<\/li>\n
- App Secrets<\/strong> when the
EnvironmentName<\/code> variable is set to “Development”<\/li>\n- Environment variables<\/strong><\/li>\n
- Command-line arguments<\/strong><\/li>\n<\/ul>\n
These key-value pairs are stored inside the IConfiguration<\/code>, and it plays a big role in our application later on.<\/p>\nNow that we know how the default configuration is populated in our application, let’s see how we can read it at runtime.<\/p>\n
<\/a>Reading Values at Runtime<\/h2>\nAfter a bit of theory, let’s do some coding.<\/p>\n
First of all, we need a way to access our values.<\/p>\n
Since dependency injection<\/a> is turned on by default in our application we can do it simply by injecting our IConfiguration<\/code> interface in our controller (or anywhere else). So let’s do exactly that. Let’s inject IConfiguration<\/code> into the HomeController<\/code> class.<\/p>\nWhen we open the HomeController<\/code>, we can immediately see that the ILogger<\/code> is already injected into the constructor:<\/p>\nprivate readonly ILogger<HomeController> _logger;\r\n\r\npublic HomeController(ILogger<HomeController> logger)\r\n{\r\n _logger = logger;\r\n}<\/pre>\nWe can inject IConfiguration in exactly the same manner:<\/p>\n
private readonly ILogger<HomeController> _logger;\r\nprivate readonly IConfiguration _configuration;\r\n\r\npublic HomeController(ILogger<HomeController> logger, IConfiguration configuration)\r\n{\r\n _logger = logger;\r\n _configuration = configuration;\r\n}<\/pre>\nNow we can use the _configuration<\/code> variable to access our values in the entire controller. Let’s create a dummy model first to populate it with our data. Let’s navigate to the Model folder and create a HomeModel<\/code> class. This will be a simple class with a single property DefaultLogLevel<\/code>:<\/p>\npublic class HomeModel\r\n{\r\n public string DefaultLogLevel { get; set; }\r\n}<\/pre>\nLet’s return to our controller, read our configuration, and send the data to our Home Index view:<\/p>\n
public IActionResult Index()\r\n{\r\n var homeModel = new HomeModel\r\n {\r\n DefaultLogLevel = _configuration.GetValue<string>(\"Logging:LogLevel:Default\")\r\n };\r\n return View(homeModel);\r\n}<\/pre>\nAnd change our Home Index.html a bit:<\/p>\n
@{\r\n ViewData[\"Title\"] = \"Home Page\";\r\n}\r\n\r\n<div class=\"text-center\">\r\n <h1 class=\"display-4\">Welcome<\/h1>\r\n <span>Our default logging level is <\/span><strong>@Model.DefaultLogLevel<\/strong>\r\n <p>Learn about <a href=\"https:\/\/docs.microsoft.com\/aspnet\/core\">building Web apps with ASP.NET Core<\/a>.<\/p>\r\n<\/div>\r\n<\/pre>\nSure enough, our application now displays our configuration value:<\/p>\n
![\"configuration](\"https:\/\/code-maze.com\/wp-content\/uploads\/2020\/07\/2020-07-26-21_14_23-Window-e1595791103705.png\")
<\/a><\/p>\nAs you can see, we’ve used a strongly typed GetValue()<\/code> method to read our default logging level, using the same principle as before to navigate the hierarchy.<\/p>\nIt’s as easy as that.<\/p>\n
<\/a>Configuration Sections<\/h2>\nThe GetSection()<\/code> method helps us further by isolating separate sections or subsections of our configuration. To put that into perspective let’s look at our example once again:<\/p>\n{\r\n\t\"Logging\": {\r\n\t\t\"LogLevel\": {\r\n\t\t\t\"Default\": \"Information\",\r\n\t\t\t\"Microsoft\": \"Warning\",\r\n\t\t\t\"Microsoft.Hosting.Lifetime\": \"Information\"\r\n\t\t}\r\n\t},\r\n\t\"OtherLoggingProvider\": {\r\n\t\t\"LogLevel\": {\r\n\t\t\t\"Default\": \"Debug\"\r\n\t\t}\r\n\t},\r\n\t\"AllowedHosts\": \"*\"\r\n}\r\n<\/pre>\nIn this case, “Logging” would be a section, and “LogLevel” is a subsection. Since we need just the LogLevel data, we can isolate it by returning just the LogLevel subsection in our HomeController Index action:<\/p>\n
public IActionResult Index()\r\n{\r\n var logLevelSection = _configuration.GetSection(\"Logging:LogLevel\");\r\n\r\n var homeModel = new HomeModel\r\n {\r\n DefaultLogLevel = logLevelSection.GetValue<string>(\"Default\")\r\n };\r\n\r\n return View(homeModel);\r\n}<\/pre>\nThe result is the same as before.<\/p>\n
Although this is a small example, imagine more complex settings file like we see every day in a real-world project. It contains a lot of different sections, for various parts of our application. Getting sections and organizing them logically would be a crucial task to make our application more readable, and less dependent on hard coded strings.<\/p>\n
A common usage of the GetSection()<\/code> method can be seen in the extension method GetConnectionString()<\/code>.<\/p>\nLet’s load it from the assembly:<\/p>\n
public static string GetConnectionString(this IConfiguration configuration, string name)\r\n{\r\n return configuration?.GetSection(\"ConnectionStrings\")?[name];\r\n}<\/pre>\nWe can see that it’s just the implementation of the GetSection() method. It takes a name of the connection string and then tries to find it within the “ConnectionStrings” section.<\/p>\n
That’s why our connection strings should be located within that section inside our appsettings.json file:<\/p>\n
{\r\n\t\"Logging\": {\r\n\t\t\"LogLevel\": {\r\n\t\t\t\"Default\": \"Information\",\r\n\t\t\t\"Microsoft\": \"Warning\",\r\n\t\t\t\"Microsoft.Hosting.Lifetime\": \"Information\"\r\n\t\t}\r\n\t},\r\n\t\"ConnectionStrings\": {\r\n\t\t\"sqlConnection\": \"server=.; database=CodeMazeCommerce; Integrated Security=true\"\r\n\t},\r\n\t\"OtherLoggingProvider\": {\r\n\t\t\"LogLevel\": {\r\n\t\t\t\"Default\": \"Debug\"\r\n\t\t}\r\n\t},\r\n\t\"AllowedHosts\": \"*\"\r\n}\r\n<\/pre>\nWe can get the string as easy as this now:<\/p>\n
Configuration.GetConnectionString(\"sqlConnection\");<\/pre>\nAwesome!<\/p>\n
We recommend that you use a similar pattern to get other sections of your configuration. If you are not familiar with extension methods check out our article<\/a> on them to learn how they work.<\/p>\n<\/a>Binding Configuration<\/h2>\nWe’ve seen how we can extract our configuration data by using IConfiguration<\/code>. But it does have its flaws.<\/p>\nHaving to type sections and keys to get the values can be really repetitive and error-prone. We risk introducing errors to our code, and these kinds of errors can cost us a lot of time until we discover them since someone else can introduce them, and we won’t notice them since a null result is returned when values are missing.<\/p>\n
To overcome this problem, we can bind the configuration data to strongly typed objects. To do that, we can use the Bind()<\/code> method.<\/p>\nWe can quickly create a simple container class for the configuration called LoggingLevelConfiguration<\/code>, inside our Model folder:<\/p>\npublic class LoggingLevelConfiguration\r\n{\r\n public string Default { get; set; }\r\n}<\/pre>\nAnd now, let’s make some changes to our HomeController<\/code> Index()<\/code> method:<\/p>\npublic IActionResult Index()\r\n{\r\n var logLevelConfiguration = new LoggingLevelConfiguration();\r\n\r\n _configuration.Bind(\"Logging:LogLevel\", logLevelConfiguration);\r\n\r\n var homeModel = new HomeModel\r\n {\r\n DefaultLogLevel = logLevelConfiguration.Default\r\n };\r\n\r\n return View(homeModel);\r\n}<\/pre>\nAnd once again, we can run the project and make sure that result is the same.<\/p>\n
As you can see, instead of using GetValue()<\/code> or GetSection()<\/code> methods we’ve bound our configuration data to the LoggingLevelConfiguration<\/code> section directly, and we’re accessing the configuration data by calling the Default<\/code> property of that class.<\/p>\nPretty neat, huh?<\/p>\n
There are two things to note here though. First is that the names of the configuration data keys and class properties must match. The other is that if you extend the configuration, you need to extend the class as well, which can be a bit cumbersome, but it beats getting values by typing strings.<\/p>\n
<\/a>Creating an Environment Specific Configuration<\/h2>\nAny application that is meant to go to the production has at least two environments – development and production. Besides that, we can have other environments, like staging which is an environment where we can check if the application is working correctly before we deploy it to production.<\/p>\n
Check out our article about using multiple environments in ASP.NET Core<\/a> to learn about it in more detail.<\/p>\nAs you might have noticed, our project template has two appsettings files. One is the default appsettings.json file, and another is appsettings.Development<\/strong>.json. In this file, we can override any value from the appsettings.json file and it will be used when we are working in the development environment.<\/p>\nThe practical example of the usage would be having different configuration strings for production and development since we don’t want to mess up the production database during development.<\/p>\n
For example, this would be a connection string for the development:<\/p>\n
{\r\n\t\"Logging\": {\r\n\t\t\"LogLevel\": {\r\n\t\t\t\"Default\": \"Information\",\r\n\t\t\t\"Microsoft\": \"Warning\",\r\n\t\t\t\"Microsoft.Hosting.Lifetime\": \"Information\"\r\n\t\t}\r\n\t},\r\n\t\"ConnectionStrings\": {\r\n\t\t\"sqlConnection\": \"server=.; database=CodeMazeCommerce; Integrated Security=true\"\r\n\t},\r\n\t\"OtherLoggingProvider\": {\r\n\t\t\"LogLevel\": {\r\n\t\t\t\"Default\": \"Debug\"\r\n\t\t}\r\n\t},\r\n\t\"AllowedHosts\": \"*\"\r\n}<\/pre>\nAnd now we can create an appsettings.Production.json file in which we will change the connection string to something else:<\/p>\n
{\r\n\t\"ConnectionStrings\": {\r\n\t\t\"sqlConnection\": \"server=ProductionServerName; database=CodeMazeCommerce; Integrated Security=true\"\r\n\t}\r\n}<\/pre>\nThat’s it. Once the application is running in the production environment (indicated by the ASPNETCORE_ENVIRONMENT<\/code> environment variable), the production string from the apsettings.Production.json will be used instead of the default one.<\/p>\n<\/a>Conclusion<\/h2>\nIn this article, we’ve gone through some basic concepts of ASP.NET Core application configuration. We’ve learned how to use change configuration settings for our application, use sections to logically group our configuration data, and read the hierarchical configuration structures.<\/p>\n
We still haven’t touched upon the options pattern<\/a> or configuration providers<\/a>, which are our next topics of this series<\/a>.<\/p><\/p>\n","protected":false},"excerpt":{"rendered":"In this introductory article, we are going to learn how ASP.NET Core configuration works, the basic configuration concepts, and a few different ways we can use to configure our application. Even by default, the configuration mechanism in .NET is pretty powerful, but it has a lot of advanced mechanisms that make it even more so. […]<\/p>\n","protected":false},"author":1,"featured_media":54346,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_et_pb_use_builder":"","_et_pb_old_content":"","_et_gb_content_width":"","footnotes":""},"categories":[12],"tags":[10,79,730,146],"class_list":["post-53545","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-csharp","tag-net","tag-asp-net-core","tag-basic","tag-configuration","et-has-post-format-content","et_post_format-et-post-format-standard"],"yoast_head":"\n
ASP.NET Core Configuration - Basic Concepts - Code Maze<\/title>\n<meta name=\"description\" content=\"In this introductory article, we are going to learn how ASP.NET Core configuration works and cover the basic configuration concepts.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/code-maze.com\/aspnet-configuration-basic-concepts\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"ASP.NET Core Configuration - Basic Concepts - Code Maze\" \/>\n<meta property=\"og:description\" content=\"In this introductory article, we are going to learn how ASP.NET Core configuration works and cover the basic configuration concepts.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/code-maze.com\/aspnet-configuration-basic-concepts\/\" \/>\n<meta property=\"og:site_name\" content=\"Code Maze\" \/>\n<meta property=\"article:published_time\" content=\"2020-09-01T06:00:16+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2021-12-27T12:50:05+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/code-maze.com\/wp-content\/uploads\/2020\/07\/configuration-basic-concepts.png\" \/>\n\t<meta property=\"og:image:width\" content=\"1100\" \/>\n\t<meta property=\"og:image:height\" content=\"620\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/png\" \/>\n<meta name=\"author\" content=\"Vladimir Pecanac\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:creator\" content=\"@https:\/\/twitter.com\/PecanacVladimir\" \/>\n<meta name=\"twitter:site\" content=\"@CodeMazeBlog\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Vladimir Pecanac\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"10 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":[\"Article\",\"BlogPosting\"],\"@id\":\"https:\/\/code-maze.com\/aspnet-configuration-basic-concepts\/#article\",\"isPartOf\":{\"@id\":\"https:\/\/code-maze.com\/aspnet-configuration-basic-concepts\/\"},\"author\":{\"name\":\"Vladimir Pecanac\",\"@id\":\"https:\/\/code-maze.com\/#\/schema\/person\/50de31ad4e1992752e972e4715d93739\"},\"headline\":\"ASP.NET Core Configuration – Basic Concepts\",\"datePublished\":\"2020-09-01T06:00:16+00:00\",\"dateModified\":\"2021-12-27T12:50:05+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\/\/code-maze.com\/aspnet-configuration-basic-concepts\/\"},\"wordCount\":1798,\"commentCount\":2,\"publisher\":{\"@id\":\"https:\/\/code-maze.com\/#organization\"},\"image\":{\"@id\":\"https:\/\/code-maze.com\/aspnet-configuration-basic-concepts\/#primaryimage\"},\"thumbnailUrl\":\"https:\/\/code-maze.com\/wp-content\/uploads\/2020\/07\/configuration-basic-concepts.png\",\"keywords\":[\".NET\",\"asp.net core\",\"Basic\",\"configuration\"],\"articleSection\":[\"C#\"],\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"CommentAction\",\"name\":\"Comment\",\"target\":[\"https:\/\/code-maze.com\/aspnet-configuration-basic-concepts\/#respond\"]}]},{\"@type\":\"WebPage\",\"@id\":\"https:\/\/code-maze.com\/aspnet-configuration-basic-concepts\/\",\"url\":\"https:\/\/code-maze.com\/aspnet-configuration-basic-concepts\/\",\"name\":\"ASP.NET Core Configuration - Basic Concepts - Code Maze\",\"isPartOf\":{\"@id\":\"https:\/\/code-maze.com\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\/\/code-maze.com\/aspnet-configuration-basic-concepts\/#primaryimage\"},\"image\":{\"@id\":\"https:\/\/code-maze.com\/aspnet-configuration-basic-concepts\/#primaryimage\"},\"thumbnailUrl\":\"https:\/\/code-maze.com\/wp-content\/uploads\/2020\/07\/configuration-basic-concepts.png\",\"datePublished\":\"2020-09-01T06:00:16+00:00\",\"dateModified\":\"2021-12-27T12:50:05+00:00\",\"description\":\"In this introductory article, we are going to learn how ASP.NET Core configuration works and cover the basic configuration concepts.\",\"breadcrumb\":{\"@id\":\"https:\/\/code-maze.com\/aspnet-configuration-basic-concepts\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/code-maze.com\/aspnet-configuration-basic-concepts\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/code-maze.com\/aspnet-configuration-basic-concepts\/#primaryimage\",\"url\":\"https:\/\/code-maze.com\/wp-content\/uploads\/2020\/07\/configuration-basic-concepts.png\",\"contentUrl\":\"https:\/\/code-maze.com\/wp-content\/uploads\/2020\/07\/configuration-basic-concepts.png\",\"width\":1100,\"height\":620,\"caption\":\"configuration basic concepts\"},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/code-maze.com\/aspnet-configuration-basic-concepts\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/code-maze.com\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"ASP.NET Core Configuration – Basic Concepts\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/code-maze.com\/#website\",\"url\":\"https:\/\/code-maze.com\/\",\"name\":\"Code Maze\",\"description\":\"Learn. Code. Succeed.\",\"publisher\":{\"@id\":\"https:\/\/code-maze.com\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/code-maze.com\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/code-maze.com\/#organization\",\"name\":\"Code Maze\",\"url\":\"https:\/\/code-maze.com\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/code-maze.com\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/code-maze.com\/wp-content\/uploads\/2020\/01\/Code-Maze-Only-Logo-Transparent-HRez.png\",\"contentUrl\":\"https:\/\/code-maze.com\/wp-content\/uploads\/2020\/01\/Code-Maze-Only-Logo-Transparent-HRez.png\",\"width\":3511,\"height\":3510,\"caption\":\"Code Maze\"},\"image\":{\"@id\":\"https:\/\/code-maze.com\/#\/schema\/logo\/image\/\"},\"sameAs\":[\"https:\/\/x.com\/CodeMazeBlog\"]},{\"@type\":\"Person\",\"@id\":\"https:\/\/code-maze.com\/#\/schema\/person\/50de31ad4e1992752e972e4715d93739\",\"name\":\"Vladimir Pecanac\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/code-maze.com\/#\/schema\/person\/image\/\",\"url\":\"https:\/\/code-maze.com\/wp-content\/uploads\/2016\/02\/profile_image-100x100.png\",\"contentUrl\":\"https:\/\/code-maze.com\/wp-content\/uploads\/2016\/02\/profile_image-100x100.png\",\"caption\":\"Vladimir Pecanac\"},\"description\":\"Hi, my name is Vladimir Pecanac, and I am a full-time .NET developer and DevOps enthusiast. I created this blog so I can share the things I learn in the hope of both helping others and deepening my own knowledge of the topics I write about. The best way to learn is to teach.\",\"sameAs\":[\"https:\/\/www.linkedin.com\/in\/vladimir-pecanac\/\",\"https:\/\/x.com\/https:\/\/twitter.com\/PecanacVladimir\"],\"url\":\"https:\/\/code-maze.com\/author\/codemaze_blog\/\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"ASP.NET Core Configuration - Basic Concepts - Code Maze","description":"In this introductory article, we are going to learn how ASP.NET Core configuration works and cover the basic configuration concepts.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/code-maze.com\/aspnet-configuration-basic-concepts\/","og_locale":"en_US","og_type":"article","og_title":"ASP.NET Core Configuration - Basic Concepts - Code Maze","og_description":"In this introductory article, we are going to learn how ASP.NET Core configuration works and cover the basic configuration concepts.","og_url":"https:\/\/code-maze.com\/aspnet-configuration-basic-concepts\/","og_site_name":"Code Maze","article_published_time":"2020-09-01T06:00:16+00:00","article_modified_time":"2021-12-27T12:50:05+00:00","og_image":[{"width":1100,"height":620,"url":"https:\/\/code-maze.com\/wp-content\/uploads\/2020\/07\/configuration-basic-concepts.png","type":"image\/png"}],"author":"Vladimir Pecanac","twitter_card":"summary_large_image","twitter_creator":"@https:\/\/twitter.com\/PecanacVladimir","twitter_site":"@CodeMazeBlog","twitter_misc":{"Written by":"Vladimir Pecanac","Est. reading time":"10 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":["Article","BlogPosting"],"@id":"https:\/\/code-maze.com\/aspnet-configuration-basic-concepts\/#article","isPartOf":{"@id":"https:\/\/code-maze.com\/aspnet-configuration-basic-concepts\/"},"author":{"name":"Vladimir Pecanac","@id":"https:\/\/code-maze.com\/#\/schema\/person\/50de31ad4e1992752e972e4715d93739"},"headline":"ASP.NET Core Configuration – Basic Concepts","datePublished":"2020-09-01T06:00:16+00:00","dateModified":"2021-12-27T12:50:05+00:00","mainEntityOfPage":{"@id":"https:\/\/code-maze.com\/aspnet-configuration-basic-concepts\/"},"wordCount":1798,"commentCount":2,"publisher":{"@id":"https:\/\/code-maze.com\/#organization"},"image":{"@id":"https:\/\/code-maze.com\/aspnet-configuration-basic-concepts\/#primaryimage"},"thumbnailUrl":"https:\/\/code-maze.com\/wp-content\/uploads\/2020\/07\/configuration-basic-concepts.png","keywords":[".NET","asp.net core","Basic","configuration"],"articleSection":["C#"],"inLanguage":"en-US","potentialAction":[{"@type":"CommentAction","name":"Comment","target":["https:\/\/code-maze.com\/aspnet-configuration-basic-concepts\/#respond"]}]},{"@type":"WebPage","@id":"https:\/\/code-maze.com\/aspnet-configuration-basic-concepts\/","url":"https:\/\/code-maze.com\/aspnet-configuration-basic-concepts\/","name":"ASP.NET Core Configuration - Basic Concepts - Code Maze","isPartOf":{"@id":"https:\/\/code-maze.com\/#website"},"primaryImageOfPage":{"@id":"https:\/\/code-maze.com\/aspnet-configuration-basic-concepts\/#primaryimage"},"image":{"@id":"https:\/\/code-maze.com\/aspnet-configuration-basic-concepts\/#primaryimage"},"thumbnailUrl":"https:\/\/code-maze.com\/wp-content\/uploads\/2020\/07\/configuration-basic-concepts.png","datePublished":"2020-09-01T06:00:16+00:00","dateModified":"2021-12-27T12:50:05+00:00","description":"In this introductory article, we are going to learn how ASP.NET Core configuration works and cover the basic configuration concepts.","breadcrumb":{"@id":"https:\/\/code-maze.com\/aspnet-configuration-basic-concepts\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/code-maze.com\/aspnet-configuration-basic-concepts\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/code-maze.com\/aspnet-configuration-basic-concepts\/#primaryimage","url":"https:\/\/code-maze.com\/wp-content\/uploads\/2020\/07\/configuration-basic-concepts.png","contentUrl":"https:\/\/code-maze.com\/wp-content\/uploads\/2020\/07\/configuration-basic-concepts.png","width":1100,"height":620,"caption":"configuration basic concepts"},{"@type":"BreadcrumbList","@id":"https:\/\/code-maze.com\/aspnet-configuration-basic-concepts\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/code-maze.com\/"},{"@type":"ListItem","position":2,"name":"ASP.NET Core Configuration – Basic Concepts"}]},{"@type":"WebSite","@id":"https:\/\/code-maze.com\/#website","url":"https:\/\/code-maze.com\/","name":"Code Maze","description":"Learn. Code. Succeed.","publisher":{"@id":"https:\/\/code-maze.com\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/code-maze.com\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/code-maze.com\/#organization","name":"Code Maze","url":"https:\/\/code-maze.com\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/code-maze.com\/#\/schema\/logo\/image\/","url":"https:\/\/code-maze.com\/wp-content\/uploads\/2020\/01\/Code-Maze-Only-Logo-Transparent-HRez.png","contentUrl":"https:\/\/code-maze.com\/wp-content\/uploads\/2020\/01\/Code-Maze-Only-Logo-Transparent-HRez.png","width":3511,"height":3510,"caption":"Code Maze"},"image":{"@id":"https:\/\/code-maze.com\/#\/schema\/logo\/image\/"},"sameAs":["https:\/\/x.com\/CodeMazeBlog"]},{"@type":"Person","@id":"https:\/\/code-maze.com\/#\/schema\/person\/50de31ad4e1992752e972e4715d93739","name":"Vladimir Pecanac","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/code-maze.com\/#\/schema\/person\/image\/","url":"https:\/\/code-maze.com\/wp-content\/uploads\/2016\/02\/profile_image-100x100.png","contentUrl":"https:\/\/code-maze.com\/wp-content\/uploads\/2016\/02\/profile_image-100x100.png","caption":"Vladimir Pecanac"},"description":"Hi, my name is Vladimir Pecanac, and I am a full-time .NET developer and DevOps enthusiast. I created this blog so I can share the things I learn in the hope of both helping others and deepening my own knowledge of the topics I write about. The best way to learn is to teach.","sameAs":["https:\/\/www.linkedin.com\/in\/vladimir-pecanac\/","https:\/\/x.com\/https:\/\/twitter.com\/PecanacVladimir"],"url":"https:\/\/code-maze.com\/author\/codemaze_blog\/"}]}},"_links":{"self":[{"href":"https:\/\/code-maze.com\/wp-json\/wp\/v2\/posts\/53545","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/code-maze.com\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/code-maze.com\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/code-maze.com\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/code-maze.com\/wp-json\/wp\/v2\/comments?post=53545"}],"version-history":[{"count":1,"href":"https:\/\/code-maze.com\/wp-json\/wp\/v2\/posts\/53545\/revisions"}],"predecessor-version":[{"id":62236,"href":"https:\/\/code-maze.com\/wp-json\/wp\/v2\/posts\/53545\/revisions\/62236"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/code-maze.com\/wp-json\/wp\/v2\/media\/54346"}],"wp:attachment":[{"href":"https:\/\/code-maze.com\/wp-json\/wp\/v2\/media?parent=53545"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/code-maze.com\/wp-json\/wp\/v2\/categories?post=53545"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/code-maze.com\/wp-json\/wp\/v2\/tags?post=53545"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}
Configuration may come from multiple different sources and in a wide variety of forms<\/strong> like files, environment variables, or some kind of store like Azure Key Vault, or even from in-memory storage or as command-line arguments.<\/p>\n Whichever way(s) we choose, the configuration mechanism exists to help us create flexible applications, without the need to recompile our source code<\/strong>. By using the configuration data we determine the behavior of our applications at runtime.<\/p>\n Configuration in .NET Core is pretty powerful and it can be easily installed and used. The NuGet package containing the configuration is If you create an ASP.NET Core application, you don’t have to worry about it since it’s referenced by default<\/strong>.<\/p>\n Configuration in .NET Core is even more powerful with the use of sections, configuration providers, and the Options pattern<\/strong>. We’ll talk about all of these concepts in this article, as well as later on.<\/p>\n Configuration data is defined as a set of key-value pairs.<\/p>\n Values can be:<\/p>\n These are just examples and besides a value, each key contains information about which level of the hierarchy it’s in.<\/p>\n Let’s see what that means.<\/p>\n The Configuration API reads the hierarchical data by flattening the structure using delimiters.<\/p>\n This means we can write something like this in our configuration file:<\/p>\n And later on, access it in our code by using the semicolon delimiter “:”.<\/p>\n Examples:<\/p>\n This means we can have multiple keys named “Default” since the organization is hierarchical.<\/p>\n Let’s extend our example:<\/p>\n Now we can access the same key within the different hierarchy:<\/p>\n If the value doesn’t exist, we’ll get a null as a result.<\/p>\n Instead of accessing the values directly, using delimiters, we can use the options pattern<\/strong>, and Let’s see what we get out of the box when we create an ASP.NET Core application.<\/p>\n When we create a new ASP.NET Core application, our Program.cs file looks like this:<\/p>\n While it may not look that spectacular, this does a few things for us. The It creates an instance of a The CreateDefaultBuilder() method adds the default configuration values to the application in this particular order:<\/p>\n These key-value pairs are stored inside the Now that we know how the default configuration is populated in our application, let’s see how we can read it at runtime.<\/p>\n After a bit of theory, let’s do some coding.<\/p>\n First of all, we need a way to access our values.<\/p>\n Since dependency injection<\/a> is turned on by default in our application we can do it simply by injecting our When we open the We can inject IConfiguration in exactly the same manner:<\/p>\n Now we can use the Let’s return to our controller, read our configuration, and send the data to our Home Index view:<\/p>\n And change our Home Index.html a bit:<\/p>\n Sure enough, our application now displays our configuration value:<\/p>\n As you can see, we’ve used a strongly typed It’s as easy as that.<\/p>\n The In this case, “Logging” would be a section, and “LogLevel” is a subsection. Since we need just the LogLevel data, we can isolate it by returning just the LogLevel subsection in our HomeController Index action:<\/p>\n The result is the same as before.<\/p>\n Although this is a small example, imagine more complex settings file like we see every day in a real-world project. It contains a lot of different sections, for various parts of our application. Getting sections and organizing them logically would be a crucial task to make our application more readable, and less dependent on hard coded strings.<\/p>\n A common usage of the Let’s load it from the assembly:<\/p>\n We can see that it’s just the implementation of the GetSection() method. It takes a name of the connection string and then tries to find it within the “ConnectionStrings” section.<\/p>\n That’s why our connection strings should be located within that section inside our appsettings.json file:<\/p>\n We can get the string as easy as this now:<\/p>\n Awesome!<\/p>\n We recommend that you use a similar pattern to get other sections of your configuration. If you are not familiar with extension methods check out our article<\/a> on them to learn how they work.<\/p>\n We’ve seen how we can extract our configuration data by using Having to type sections and keys to get the values can be really repetitive and error-prone. We risk introducing errors to our code, and these kinds of errors can cost us a lot of time until we discover them since someone else can introduce them, and we won’t notice them since a null result is returned when values are missing.<\/p>\n To overcome this problem, we can bind the configuration data to strongly typed objects. To do that, we can use the We can quickly create a simple container class for the configuration called And now, let’s make some changes to our And once again, we can run the project and make sure that result is the same.<\/p>\n As you can see, instead of using Pretty neat, huh?<\/p>\n There are two things to note here though. First is that the names of the configuration data keys and class properties must match. The other is that if you extend the configuration, you need to extend the class as well, which can be a bit cumbersome, but it beats getting values by typing strings.<\/p>\n Any application that is meant to go to the production has at least two environments – development and production. Besides that, we can have other environments, like staging which is an environment where we can check if the application is working correctly before we deploy it to production.<\/p>\n Check out our article about using multiple environments in ASP.NET Core<\/a> to learn about it in more detail.<\/p>\n As you might have noticed, our project template has two appsettings files. One is the default appsettings.json file, and another is appsettings.Development<\/strong>.json. In this file, we can override any value from the appsettings.json file and it will be used when we are working in the development environment.<\/p>\n The practical example of the usage would be having different configuration strings for production and development since we don’t want to mess up the production database during development.<\/p>\n For example, this would be a connection string for the development:<\/p>\n And now we can create an appsettings.Production.json file in which we will change the connection string to something else:<\/p>\n That’s it. Once the application is running in the production environment (indicated by the In this article, we’ve gone through some basic concepts of ASP.NET Core application configuration. We’ve learned how to use change configuration settings for our application, use sections to logically group our configuration data, and read the hierarchical configuration structures.<\/p>\n We still haven’t touched upon the options pattern<\/a> or configuration providers<\/a>, which are our next topics of this series<\/a>.<\/p><\/p>\n","protected":false},"excerpt":{"rendered":" In this introductory article, we are going to learn how ASP.NET Core configuration works, the basic configuration concepts, and a few different ways we can use to configure our application. Even by default, the configuration mechanism in .NET is pretty powerful, but it has a lot of advanced mechanisms that make it even more so. […]<\/p>\n","protected":false},"author":1,"featured_media":54346,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_et_pb_use_builder":"","_et_pb_old_content":"","_et_gb_content_width":"","footnotes":""},"categories":[12],"tags":[10,79,730,146],"class_list":["post-53545","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-csharp","tag-net","tag-asp-net-core","tag-basic","tag-configuration","et-has-post-format-content","et_post_format-et-post-format-standard"],"yoast_head":"\nMicrosoft.Extensions.Configuration<\/code> and you can easily add it to any .NET Core project by typing:<\/p>\nPM> Install-Package Microsoft.Extensions.Configuration<\/code> in the Package Manager Console in Visual Studio or
\ndotnet add package Microsoft.Extensions.Configuration<\/code> if you prefer the dotnet CLI.<\/p>\n<\/a>How do We Define Configuration Data?<\/h2>\n
\n
\nDefaultRoomTemperature = 21<\/code><\/li>\n
\nTurnOnDetailedReports = true<\/code><\/li>\n
\nsqlConnection\u00a0=<\/span><\/span>\u00a0\"<\/span>server=.; database=AccountOwnerDatabase; Integrated Security=true\"<\/span><\/span><\/code><\/li>\n<\/ul>\n<\/a>Hierarchical Data Organization and Data Flattening<\/h2>\n
{\r\n\t\"Logging\": {\r\n\t\t\"LogLevel\": {\r\n\t\t\t\"Default\": \"Information\",\r\n\t\t\t\"Microsoft\": \"Warning\",\r\n\t\t\t\"Microsoft.Hosting.Lifetime\": \"Information\"\r\n\t\t}\r\n\t},\r\n\t\"AllowedHosts\": \"*\"\r\n}\r\n<\/pre>\n\"Logging:LogLevel:Default\"<\/code> – We can get the Default logging level
\n\"AllowedHosts\"<\/code> – We’ll get “*” (any host) in this case<\/p>\n{\r\n\t\"Logging\": {\r\n\t\t\"LogLevel\": {\r\n\t\t\t\"Default\": \"Information\",\r\n\t\t\t\"Microsoft\": \"Warning\",\r\n\t\t\t\"Microsoft.Hosting.Lifetime\": \"Information\"\r\n\t\t}\r\n\t},\r\n\t\"OtherLoggingProvider\": {\r\n\t\t\"LogLevel\": {\r\n\t\t\t\"Default\": \"Debug\"\r\n\t\t}\r\n\t},\r\n\t\"AllowedHosts\": \"*\"\r\n}<\/pre>\n\"Logging:LogLevel:Default\"<\/code> – returns “Information”
\n\"OtherLoggingProvider:LogLevel:Default\"<\/code> – returns “Debug”<\/p>\nGetSection()<\/code> and GetChildren()<\/code> methods to get sections and children of a section. These mechanisms make the configuration much easier to use. We’ll see how to use them later on.<\/p>\n<\/a>Default ASP.NET Core Configuration<\/h2>\n
public class Program\r\n{\r\n public static void Main(string[] args)\r\n {\r\n CreateHostBuilder(args).Build().Run();\r\n }\r\n\r\n public static IHostBuilder CreateHostBuilder(string[] args) =>\r\n Host.CreateDefaultBuilder(args)\r\n .ConfigureWebHostDefaults(webBuilder =>\r\n {\r\n webBuilder.UseStartup<Startup>();\r\n });\r\n}<\/pre>\nCreateDefaultBuilder()<\/code> method is particularly interesting to us.<\/p>\nHostBuilder<\/code>, which implements IHostBuilder<\/code> and that’s our program initialization utility. Besides that, it populates it with some default values, some of which are the default values gathered from different sources.<\/p>\n\n
IConfiguration<\/code> to the app<\/em> IConfiguration<\/code><\/li>\nEnvironmentName<\/code> variable is set to “Development”<\/li>\nIConfiguration<\/code>, and it plays a big role in our application later on.<\/p>\n<\/a>Reading Values at Runtime<\/h2>\n
IConfiguration<\/code> interface in our controller (or anywhere else). So let’s do exactly that. Let’s inject IConfiguration<\/code> into the HomeController<\/code> class.<\/p>\nHomeController<\/code>, we can immediately see that the ILogger<\/code> is already injected into the constructor:<\/p>\nprivate readonly ILogger<HomeController> _logger;\r\n\r\npublic HomeController(ILogger<HomeController> logger)\r\n{\r\n _logger = logger;\r\n}<\/pre>\nprivate readonly ILogger<HomeController> _logger;\r\nprivate readonly IConfiguration _configuration;\r\n\r\npublic HomeController(ILogger<HomeController> logger, IConfiguration configuration)\r\n{\r\n _logger = logger;\r\n _configuration = configuration;\r\n}<\/pre>\n_configuration<\/code> variable to access our values in the entire controller. Let’s create a dummy model first to populate it with our data. Let’s navigate to the Model folder and create a HomeModel<\/code> class. This will be a simple class with a single property DefaultLogLevel<\/code>:<\/p>\npublic class HomeModel\r\n{\r\n public string DefaultLogLevel { get; set; }\r\n}<\/pre>\npublic IActionResult Index()\r\n{\r\n var homeModel = new HomeModel\r\n {\r\n DefaultLogLevel = _configuration.GetValue<string>(\"Logging:LogLevel:Default\")\r\n };\r\n return View(homeModel);\r\n}<\/pre>\n@{\r\n ViewData[\"Title\"] = \"Home Page\";\r\n}\r\n\r\n<div class=\"text-center\">\r\n <h1 class=\"display-4\">Welcome<\/h1>\r\n <span>Our default logging level is <\/span><strong>@Model.DefaultLogLevel<\/strong>\r\n <p>Learn about <a href=\"https:\/\/docs.microsoft.com\/aspnet\/core\">building Web apps with ASP.NET Core<\/a>.<\/p>\r\n<\/div>\r\n<\/pre>\n<\/a><\/p>\nGetValue()<\/code> method to read our default logging level, using the same principle as before to navigate the hierarchy.<\/p>\n<\/a>Configuration Sections<\/h2>\n
GetSection()<\/code> method helps us further by isolating separate sections or subsections of our configuration. To put that into perspective let’s look at our example once again:<\/p>\n{\r\n\t\"Logging\": {\r\n\t\t\"LogLevel\": {\r\n\t\t\t\"Default\": \"Information\",\r\n\t\t\t\"Microsoft\": \"Warning\",\r\n\t\t\t\"Microsoft.Hosting.Lifetime\": \"Information\"\r\n\t\t}\r\n\t},\r\n\t\"OtherLoggingProvider\": {\r\n\t\t\"LogLevel\": {\r\n\t\t\t\"Default\": \"Debug\"\r\n\t\t}\r\n\t},\r\n\t\"AllowedHosts\": \"*\"\r\n}\r\n<\/pre>\npublic IActionResult Index()\r\n{\r\n var logLevelSection = _configuration.GetSection(\"Logging:LogLevel\");\r\n\r\n var homeModel = new HomeModel\r\n {\r\n DefaultLogLevel = logLevelSection.GetValue<string>(\"Default\")\r\n };\r\n\r\n return View(homeModel);\r\n}<\/pre>\nGetSection()<\/code> method can be seen in the extension method GetConnectionString()<\/code>.<\/p>\npublic static string GetConnectionString(this IConfiguration configuration, string name)\r\n{\r\n return configuration?.GetSection(\"ConnectionStrings\")?[name];\r\n}<\/pre>\n{\r\n\t\"Logging\": {\r\n\t\t\"LogLevel\": {\r\n\t\t\t\"Default\": \"Information\",\r\n\t\t\t\"Microsoft\": \"Warning\",\r\n\t\t\t\"Microsoft.Hosting.Lifetime\": \"Information\"\r\n\t\t}\r\n\t},\r\n\t\"ConnectionStrings\": {\r\n\t\t\"sqlConnection\": \"server=.; database=CodeMazeCommerce; Integrated Security=true\"\r\n\t},\r\n\t\"OtherLoggingProvider\": {\r\n\t\t\"LogLevel\": {\r\n\t\t\t\"Default\": \"Debug\"\r\n\t\t}\r\n\t},\r\n\t\"AllowedHosts\": \"*\"\r\n}\r\n<\/pre>\nConfiguration.GetConnectionString(\"sqlConnection\");<\/pre>\n
<\/a>Binding Configuration<\/h2>\n
IConfiguration<\/code>. But it does have its flaws.<\/p>\nBind()<\/code> method.<\/p>\nLoggingLevelConfiguration<\/code>, inside our Model folder:<\/p>\npublic class LoggingLevelConfiguration\r\n{\r\n public string Default { get; set; }\r\n}<\/pre>\nHomeController<\/code> Index()<\/code> method:<\/p>\npublic IActionResult Index()\r\n{\r\n var logLevelConfiguration = new LoggingLevelConfiguration();\r\n\r\n _configuration.Bind(\"Logging:LogLevel\", logLevelConfiguration);\r\n\r\n var homeModel = new HomeModel\r\n {\r\n DefaultLogLevel = logLevelConfiguration.Default\r\n };\r\n\r\n return View(homeModel);\r\n}<\/pre>\nGetValue()<\/code> or GetSection()<\/code> methods we’ve bound our configuration data to the LoggingLevelConfiguration<\/code> section directly, and we’re accessing the configuration data by calling the Default<\/code> property of that class.<\/p>\n<\/a>Creating an Environment Specific Configuration<\/h2>\n
{\r\n\t\"Logging\": {\r\n\t\t\"LogLevel\": {\r\n\t\t\t\"Default\": \"Information\",\r\n\t\t\t\"Microsoft\": \"Warning\",\r\n\t\t\t\"Microsoft.Hosting.Lifetime\": \"Information\"\r\n\t\t}\r\n\t},\r\n\t\"ConnectionStrings\": {\r\n\t\t\"sqlConnection\": \"server=.; database=CodeMazeCommerce; Integrated Security=true\"\r\n\t},\r\n\t\"OtherLoggingProvider\": {\r\n\t\t\"LogLevel\": {\r\n\t\t\t\"Default\": \"Debug\"\r\n\t\t}\r\n\t},\r\n\t\"AllowedHosts\": \"*\"\r\n}<\/pre>\n{\r\n\t\"ConnectionStrings\": {\r\n\t\t\"sqlConnection\": \"server=ProductionServerName; database=CodeMazeCommerce; Integrated Security=true\"\r\n\t}\r\n}<\/pre>\nASPNETCORE_ENVIRONMENT<\/code> environment variable), the production string from the apsettings.Production.json will be used instead of the default one.<\/p>\n<\/a>Conclusion<\/h2>\n