Microsoft.Extensions.Configuration 10.0.0

About

Microsoft.Extensions.Configuration is combined with a core configuration abstraction under Microsoft.Extensions.Configuration.Abstractions that allows for building different kinds of configuration providers to retrieve key/value pair configuration values from in the form of IConfiguration. There are a number of built-in configuration provider implementations to read from environment variables, in-memory collections, JSON, INI or XML files. Aside from the built-in variations, there are more shipped libraries shipped by community for integration with various configuration service and other data sources.

Key Features

  • In-memory configuration provider
  • Chained configuration provider for chaining multiple confiugration providers together.
  • Base types that implement configuration abstraction interfaces that can be used when implementing other configuration providers.

How to Use

using Microsoft.Extensions.Configuration;

var configurationBuilder = new ConfigurationBuilder();

configurationBuilder.AddInMemoryCollection(
    new Dictionary<string, string?>
    {
        ["Setting1"] = "value",
        ["MyOptions:Enabled"] = bool.TrueString,
    });

configurationBuilder.AddInMemoryCollection(
    new Dictionary<string, string?>
    {
        ["Setting2"] = "value2",
        ["MyOptions:Enabled"] = bool.FalseString,
    });

var config = configurationBuilder.Build();

// note case-insensitive
Console.WriteLine(config["setting1"]);
Console.WriteLine(config["setting2"]);

// note last in wins
Console.WriteLine(config["MyOptions:Enabled"]);

Main Types

The main types provided by this library are:

  • Microsoft.Extensions.Configuration.ConfigurationBuilder
  • Microsoft.Extensions.Configuration.ConfigurationManager
  • Microsoft.Extensions.Configuration.ConfigurationRoot
  • Microsoft.Extensions.Configuration.ConfigurationSection

Additional Documentation

Feedback & Contributing

Microsoft.Extensions.Configuration is released as open source under the MIT license. Bug reports and contributions are welcome at the GitHub repository.

Showing the top 20 packages that depend on Microsoft.Extensions.Configuration.

Packages Downloads
Microsoft.Extensions.Configuration.Binder
Functionality to bind an object to data in configuration providers for Microsoft.Extensions.Configuration.
5,471
Microsoft.Extensions.Configuration.Binder
Functionality to bind an object to data in configuration providers for Microsoft.Extensions.Configuration.
9,358
Microsoft.Extensions.Configuration.CommandLine
Command line configuration provider implementation for Microsoft.Extensions.Configuration.
5,500
Microsoft.Extensions.Configuration.CommandLine
Command line configuration provider implementation for Microsoft.Extensions.Configuration.
9,401
Microsoft.Extensions.Configuration.CommandLine
Command line configuration provider implementation for Microsoft.Extensions.Configuration. This package enables you to read configuration parameters from the command line arguments of your application. You can use CommandLineConfigurationExtensions.AddCommandLine extension method on IConfigurationBuilder to add the command line configuration provider to the configuration builder.
314
Microsoft.Extensions.Configuration.EnvironmentVariables
Environment variables configuration provider implementation for Microsoft.Extensions.Configuration.
5,466
Microsoft.Extensions.Configuration.EnvironmentVariables
Environment variables configuration provider implementation for Microsoft.Extensions.Configuration.
9,425
Microsoft.Extensions.Configuration.EnvironmentVariables
Environment variables configuration provider implementation for Microsoft.Extensions.Configuration. This package enables you to read configuration parameters from environment variables. You can use EnvironmentVariablesExtensions.AddEnvironmentVariables extension method on IConfigurationBuilder to add the environment variables configuration provider to the configuration builder.
321
Microsoft.Extensions.Configuration.FileExtensions
Extension methods for configuring file-based configuration providers for Microsoft.Extensions.Configuration.
5,596
Microsoft.Extensions.Configuration.FileExtensions
Extension methods for configuring file-based configuration providers for Microsoft.Extensions.Configuration.
9,614
Microsoft.Extensions.Configuration.FileExtensions
Provides a base class for file-based configuration providers used with Microsoft.Extensions.Configuration and extension methods for configuring them.
298
Microsoft.Extensions.Configuration.Json
JSON configuration provider implementation for Microsoft.Extensions.Configuration.
5,534
Microsoft.Extensions.Configuration.Json
JSON configuration provider implementation for Microsoft.Extensions.Configuration.
9,405
Microsoft.Extensions.Configuration.Json
JSON configuration provider implementation for Microsoft.Extensions.Configuration. This package enables you to read your application's settings from a JSON file. You can use JsonConfigurationExtensions.AddJsonFile extension method on IConfigurationBuilder to add the JSON configuration provider to the configuration builder.
300
Microsoft.Extensions.Diagnostics
This package includes the default implementation of IMeterFactory and additional extension methods to easily register it with the Dependency Injection framework.
473
Microsoft.Extensions.Hosting
Hosting and startup infrastructures for applications.
275
Microsoft.Extensions.Hosting
.NET Core hosting and startup infrastructures for applications.
209
Microsoft.Extensions.Hosting
.NET Core hosting and startup infrastructures for applications.
5,384
Microsoft.Extensions.Hosting
.NET Core hosting and startup infrastructures for applications.
9,295
Microsoft.Extensions.Logging.Configuration
Configuration support for Microsoft.Extensions.Logging.
303

https://go.microsoft.com/fwlink/?LinkID=799421

Version Downloads Last updated
10.0.0 40 11/13/2025
10.0.0-rc.2.25502.107 30 10/20/2025
10.0.0-rc.1.25451.107 35 09/15/2025
10.0.0-preview.7.25380.108 29 08/15/2025
10.0.0-preview.6.25358.103 35 07/21/2025
10.0.0-preview.5.25277.114 43 06/08/2025
10.0.0-preview.4.25258.110 42 05/16/2025
10.0.0-preview.3.25171.5 37 04/26/2025
10.0.0-preview.2.25163.2 44 03/30/2025
10.0.0-preview.1.25080.5 36 02/27/2025
9.0.11 23 11/15/2025
9.0.10 33 10/18/2025
9.0.9 39 09/13/2025
9.0.8 37 08/09/2025
9.0.7 34 07/11/2025
9.0.6 43 06/15/2025
9.0.5 40 05/17/2025
9.0.4 44 04/27/2025
9.0.3 47 03/15/2025
9.0.2 50 02/18/2025
9.0.1 53 01/17/2025
9.0.0 122 11/29/2024
9.0.0-rc.2.24473.5 41 11/17/2024
9.0.0-rc.1.24431.7 44 11/14/2024
9.0.0-preview.7.24405.7 42 11/14/2024
9.0.0-preview.6.24327.7 41 11/27/2024
9.0.0-preview.5.24306.7 41 11/28/2024
9.0.0-preview.4.24266.19 48 05/30/2024
9.0.0-preview.3.24172.9 49 04/24/2024
9.0.0-preview.2.24128.5 47 05/02/2024
9.0.0-preview.1.24080.9 48 05/16/2024
8.0.0 360 02/04/2024
8.0.0-rc.2.23479.6 51 05/16/2024
8.0.0-rc.1.23419.4 48 05/31/2024
8.0.0-preview.7.23375.6 56 05/31/2024
8.0.0-preview.6.23329.7 63 08/07/2023
8.0.0-preview.5.23280.8 50 05/31/2024
8.0.0-preview.4.23259.5 49 05/31/2024
8.0.0-preview.3.23174.8 40 05/31/2024
8.0.0-preview.2.23128.3 43 05/16/2024
8.0.0-preview.1.23110.8 56 05/16/2024
7.0.0 113 02/02/2023
7.0.0-rc.2.22472.3 48 05/31/2024
7.0.0-rc.1.22426.10 50 05/31/2024
7.0.0-preview.7.22375.6 54 05/16/2024
7.0.0-preview.6.22324.4 47 05/30/2024
7.0.0-preview.5.22301.12 48 05/31/2024
7.0.0-preview.4.22229.4 48 05/16/2024
7.0.0-preview.3.22175.4 45 05/25/2024
7.0.0-preview.1.22076.8 39 05/31/2024
6.0.2 46 11/19/2024
6.0.2-mauipre.1.22102.15 52 05/31/2024
6.0.2-mauipre.1.22054.8 46 05/31/2024
6.0.0-rc.2.21480.5 46 05/31/2024
6.0.0-rc.1.21451.13 41 11/03/2022
6.0.0-preview.7.21377.19 41 05/31/2024
6.0.0-preview.6.21352.12 57 05/31/2024
6.0.0-preview.5.21301.5 49 05/31/2024
6.0.0-preview.3.21201.4 44 05/31/2024
6.0.0-preview.1.21102.12 50 05/31/2024
5.0.0-rc.1.20451.14 49 05/31/2024
5.0.0-preview.8.20407.11 47 05/31/2024
5.0.0-preview.7.20364.11 49 05/30/2024
5.0.0-preview.6.20305.6 43 05/31/2024
5.0.0-preview.5.20278.1 47 05/31/2024
5.0.0-preview.4.20251.6 44 05/31/2024
5.0.0-preview.3.20215.2 41 05/31/2024
5.0.0-preview.2.20160.3 46 05/31/2024
5.0.0-preview.1.20120.4 49 05/31/2024
3.1.32 9,360 05/12/2023
3.1.31 53 05/31/2024
3.1.30 5,470 11/03/2022
3.1.29 60 09/29/2022
3.1.28 55 05/16/2024
3.1.27 53 05/31/2024
3.1.26 53 07/09/2022
3.1.25 54 05/31/2024
3.1.23 71 06/08/2023
3.1.22 49 05/31/2024
3.1.18 58 05/31/2024
3.1.14 50 05/31/2024
3.1.11 45 05/31/2024
3.1.0-preview3.19553.2 49 11/04/2022
3.1.0-preview2.19525.4 47 05/16/2024
3.1.0-preview1.19506.1 49 11/28/2024
3.0.1 53 05/29/2024
3.0.0-preview9.19423.4 44 05/31/2024
3.0.0-preview8.19405.4 40 05/31/2024
3.0.0-preview6.19304.6 56 05/31/2024
3.0.0-preview5.19227.9 46 05/31/2024
3.0.0-preview.19074.2 46 05/21/2024
2.2.0-preview2-35157 50 05/31/2024
2.2.0-preview1-35029 50 05/07/2024
1.1.1 52 05/29/2024
1.1.0 51 05/29/2024
1.0.0-rc2-final 66 05/10/2024