Configuration Providers in .NET. Configuration in .NET is achievable…
By: Sukhpinder Singh
Tags: Dotnet Core, Csharp, Aspnet, Aspnetcore, Dotnet

C# CONCEPTS

Configuration Providers in .NET

There are different types of providers that rely on many configuration sources. The article details each of the configuration provider's variants and their corresponding sources.

File configuration provider

Environment variable configuration provider

Command-line configuration provider

Key-per-file configuration provider

Memory configuration provider

Why is the configuration required?

Configuration in .NET is the capability to bind values to instances of .NET objects.

For example, the JSON provider can be utilized to map appsettings.json files to .NET objects with dependency injection. It enables the options pattern, i.e. classes to provide strongly typed access to collections of similar settings.

File configuration provider

FileConfigurationProvider is the base class for packing configuration from the file. The following providers derive from FileConfigurationProvider :

JSON configuration provider

XML configuration provider

INI configuration provider

JSON configuration provider

The JsonConfigurationProvider class loads key-value from a JSON file. Install the Microsoft.Extensions.Configuration.Json NuGet package.

Overloads can be specified:

If the file is optional

Whether the configuration will be reloaded if the file changes

Consider the following code:

The earlier code:

Clears all existing key-value pairs providers by default added in the CreateDefaultBuilder(String[]) function inside Program.cs file.

Sets the JSON configuration provider to load the appsettings.json and appsettings.Environment.json files with the following options:

files with the following options: optional: true : The file is optional.

: The file is optional. reloadOnChange: true : Reloaded when file changes are saved.

XML configuration provider

The XmlConfigurationProvider class loads key-value pairs from an XML file at runtime. Install the Microsoft.Extensions.Configuration.Xml NuGet package.

The following snippet demonstrates the configuration of XML files using the XML configuration provider inside Program.cs file.

The above code:

Clears all existing key-value pairs by default added in the CreateDefaultBuilder(String[]) function inside Program.cs file.

Build the XML provider to load the appsettings.xml and repeating-example.xml files with the following options:

optional: true : The file is optional.

: The file is optional. reloadOnChange: true : Reloaded when any file changes are done.

: Reloaded when any file changes are done. Build the command-line configuration provider if the given args contains arguments.

INI configuration provider

The IniConfigurationProvider class loads key-value pairs from an INI file at runtime. Install the Microsoft.Extensions.Configuration.Ini NuGet package.

The following code snippet clears all the configuration providers and adds the IniConfigurationProvider with two INI files as the source:

Environment variable configuration provider

The EnvironmentVariablesConfigurationProvider builds configuration from environment variable key-value pairs after reading appsettings.json , appsettings.Environment.json , and Secret manager .

Therefore, key-value pairs from the environment override values read from appsettings.json , appsettings.Environment.json , and Secret manager .

The following set commands:

Set the environment keys-values of the preceding example on Windows.

Test the settings by changing them from their default values. The dotnet run command must be run in the project directory.

set SecretKey="Secret key from environment"

set TransientFaultHandlingOptions__Enabled="true"

set TransientFaultHandlingOptions__AutoRetryDelay="00:00:13" dotnet run

The above environment settings:

Are only set in the current command line session. In other words, these settings are not accessible from another command prompt window.

Web applications launched from the Visual Studio cannot access the settings.

Command-line configuration provider

Using the default configuration, the CommandLineConfigurationProvider load's configuration from command-line argument key-value pairs after the following configuration sources:

appsettings.json and appsettings.Environment.json files.

files. Secret Manager in the Dev environment.

environment. Environment variables in windows.

Configuration key-value pairs set on the command line override values set with all the other configuration providers by default.

Command-line arguments

The following command sets keys-values using = :

dotnet run SecretKey="Secret key from command line"

The following command sets keys-values using. / :

dotnet run /SecretKey "Secret key set from forward slash"

The following command sets keys-values using. -- :

dotnet run --SecretKey "Secret key set from double hyphen"

The key-value:

The key must have a prefix of = or -- or / when the value follows a space.

or when the value follows a space. Isn’t required if = is used. For example, SomeKey= .

Key-per-file configuration provider

The KeyPerFileConfiguration provider uses a file directory as a configuration for key-value pairs.

The key is the file name. The value is the file’s contents.

To activate the key-per-file configuration, call the AddKeyPerFile extension method on an instance of ConfigurationBuilder. The directoryPath to the files must be an absolute path.

The double-underscore ( __ ) is used as a key delimiter in file names.

.ConfigureAppConfiguration((_, configuration) =>

{

var path = Path.Combine(

Directory.GetCurrentDirectory(), "path/to/files"); configuration.AddKeyPerFile(directoryPath: path, optional: true);

})

Memory configuration provider

The MemoryConfiguration provider uses memory collection as a store for key-value pairs.

The following code snippet adds a memory collection to the configuration system: