Microsoft.Extensions.Configuration 10.0.2
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.ConfigurationBuilderMicrosoft.Extensions.Configuration.ConfigurationManagerMicrosoft.Extensions.Configuration.ConfigurationRootMicrosoft.Extensions.Configuration.ConfigurationSection
Additional Documentation
Related Packages
- Microsoft.Extensions.Configuration.Binder
- Microsoft.Extensions.Configuration.CommandLine
- Microsoft.Extensions.Configuration.EnvironmentVariables
- Microsoft.Extensions.Configuration.FileExtensions
- Microsoft.Extensions.Configuration.Ini
- Microsoft.Extensions.Configuration.Json
- Microsoft.Extensions.Configuration.UserSecrets
- Microsoft.Extensions.Configuration.Xml
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.AspNetCore.Hosting
ASP.NET Core hosting infrastructure and startup logic for web applications.
|
598 |
|
Microsoft.AspNetCore.Hosting
ASP.NET Core hosting infrastructure and startup logic for web applications.
This package was built from the source code at https://github.com/aspnet/Hosting/tree/0724e6cde1149ee1a19bfec9c13a2c9327b71213
|
628 |
|
Microsoft.Extensions.Configuration.Binder
Functionality to bind an object to data in configuration providers for Microsoft.Extensions.Configuration.
|
464 |
|
Microsoft.Extensions.Configuration.Binder
Functionality to bind an object to data in configuration providers for Microsoft.Extensions.Configuration.
|
559 |
|
Microsoft.Extensions.Configuration.Binder
Functionality to bind an object to data in configuration providers for Microsoft.Extensions.Configuration.
|
735 |
|
Microsoft.Extensions.Configuration.Binder
Functionality to bind an object to data in configuration providers for Microsoft.Extensions.Configuration.
This package was built from the source code at https://github.com/aspnet/Extensions/tree/9bc79b2f25a3724376d7af19617c33749a30ea3a
|
735 |
|
Microsoft.Extensions.Configuration.CommandLine
Command line configuration provider implementation for Microsoft.Extensions.Configuration.
|
141 |
|
Microsoft.Extensions.Configuration.CommandLine
Command line configuration provider implementation for Microsoft.Extensions.Configuration.
This package was built from the source code at https://github.com/aspnet/Extensions/tree/9bc79b2f25a3724376d7af19617c33749a30ea3a
|
689 |
|
Microsoft.Extensions.Configuration.EnvironmentVariables
Environment variables configuration provider implementation for Microsoft.Extensions.Configuration.
|
145 |
|
Microsoft.Extensions.Configuration.EnvironmentVariables
Environment variables configuration provider implementation for Microsoft.Extensions.Configuration.
|
588 |
|
Microsoft.Extensions.Configuration.EnvironmentVariables
Environment variables configuration provider implementation for Microsoft.Extensions.Configuration.
This package was built from the source code at https://github.com/aspnet/Extensions/tree/9bc79b2f25a3724376d7af19617c33749a30ea3a
|
685 |
|
Microsoft.Extensions.Configuration.FileExtensions
Extension methods for configuring file-based configuration providers for Microsoft.Extensions.Configuration.
|
156 |
|
Microsoft.Extensions.Configuration.FileExtensions
Extension methods for configuring file-based configuration providers for Microsoft.Extensions.Configuration.
This package was built from the source code at https://github.com/aspnet/Extensions/tree/9bc79b2f25a3724376d7af19617c33749a30ea3a
|
665 |
|
Microsoft.Extensions.Configuration.FileExtensions
Provides a base class for file-based configuration providers used with Microsoft.Extensions.Configuration and extension methods for configuring them.
|
44 |
|
Microsoft.Extensions.Configuration.Json
JSON configuration provider implementation for Microsoft.Extensions.Configuration.
|
156 |
|
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.
|
45 |
|
Microsoft.Extensions.Configuration.Json
JSON configuration provider implementation for Microsoft.Extensions.Configuration.
This package was built from the source code at https://github.com/aspnet/Extensions/tree/9bc79b2f25a3724376d7af19617c33749a30ea3a
|
633 |
|
Microsoft.Extensions.Hosting
Hosting and startup infrastructures for applications.
|
32 |
|
Microsoft.Extensions.Hosting
Hosting and startup infrastructures for applications.
|
145 |
|
Microsoft.Extensions.Logging.Configuration
Configuration support for Microsoft.Extensions.Logging.
|
146 |
https://go.microsoft.com/fwlink/?LinkID=799421
.NET Framework 4.6.2
- Microsoft.Extensions.Configuration.Abstractions (>= 10.0.2)
- Microsoft.Extensions.Primitives (>= 10.0.2)
.NET 8.0
- Microsoft.Extensions.Configuration.Abstractions (>= 10.0.2)
- Microsoft.Extensions.Primitives (>= 10.0.2)
.NET 9.0
- Microsoft.Extensions.Configuration.Abstractions (>= 10.0.2)
- Microsoft.Extensions.Primitives (>= 10.0.2)
.NET 10.0
- Microsoft.Extensions.Configuration.Abstractions (>= 10.0.2)
- Microsoft.Extensions.Primitives (>= 10.0.2)
.NET Standard 2.0
- Microsoft.Extensions.Configuration.Abstractions (>= 10.0.2)
- Microsoft.Extensions.Primitives (>= 10.0.2)
| Version | Downloads | Last updated |
|---|---|---|
| 10.0.2 | 1 | 01/16/2026 |
| 10.0.1 | 4 | 12/11/2025 |
| 10.0.0 | 6 | 11/13/2025 |
| 10.0.0-rc.2.25502.107 | 7 | 10/16/2025 |
| 10.0.0-rc.1.25451.107 | 7 | 09/11/2025 |
| 10.0.0-preview.7.25380.108 | 10 | 08/14/2025 |
| 10.0.0-preview.6.25358.103 | 9 | 07/16/2025 |
| 10.0.0-preview.5.25277.114 | 11 | 06/07/2025 |
| 10.0.0-preview.4.25258.110 | 11 | 05/13/2025 |
| 10.0.0-preview.3.25171.5 | 13 | 04/26/2025 |
| 10.0.0-preview.2.25163.2 | 12 | 03/29/2025 |
| 10.0.0-preview.1.25080.5 | 10 | 03/29/2025 |
| 9.0.12 | 1 | 01/16/2026 |
| 9.0.11 | 6 | 11/14/2025 |
| 9.0.10 | 6 | 10/16/2025 |
| 9.0.9 | 6 | 09/11/2025 |
| 9.0.8 | 7 | 08/07/2025 |
| 9.0.7 | 7 | 07/14/2025 |
| 9.0.6 | 8 | 06/15/2025 |
| 9.0.5 | 11 | 05/16/2025 |
| 9.0.4 | 10 | 04/29/2025 |
| 9.0.3 | 12 | 03/29/2025 |
| 9.0.2 | 10 | 02/20/2025 |
| 9.0.1 | 10 | 01/18/2025 |
| 9.0.0 | 20 | 01/13/2025 |
| 9.0.0-rc.2.24473.5 | 10 | 01/18/2025 |
| 9.0.0-rc.1.24431.7 | 12 | 12/11/2024 |
| 9.0.0-preview.7.24405.7 | 11 | 01/18/2025 |
| 9.0.0-preview.6.24327.7 | 10 | 01/18/2025 |
| 9.0.0-preview.5.24306.7 | 12 | 01/18/2025 |
| 9.0.0-preview.4.24266.19 | 11 | 01/18/2025 |
| 9.0.0-preview.3.24172.9 | 11 | 01/18/2025 |
| 9.0.0-preview.2.24128.5 | 13 | 03/29/2024 |
| 9.0.0-preview.1.24080.9 | 13 | 02/15/2024 |
| 8.0.0 | 50 | 11/15/2023 |
| 8.0.0-rc.2.23479.6 | 15 | 03/06/2024 |
| 8.0.0-rc.1.23419.4 | 12 | 03/16/2024 |
| 8.0.0-preview.7.23375.6 | 13 | 03/10/2024 |
| 8.0.0-preview.6.23329.7 | 15 | 03/09/2024 |
| 8.0.0-preview.5.23280.8 | 15 | 03/14/2024 |
| 8.0.0-preview.4.23259.5 | 11 | 03/09/2024 |
| 8.0.0-preview.3.23174.8 | 13 | 03/08/2024 |
| 8.0.0-preview.2.23128.3 | 15 | 03/09/2024 |
| 8.0.0-preview.1.23110.8 | 16 | 03/09/2024 |
| 7.0.0 | 236 | 08/18/2023 |
| 7.0.0-rc.2.22472.3 | 15 | 03/07/2024 |
| 7.0.0-rc.1.22426.10 | 13 | 03/07/2024 |
| 7.0.0-preview.7.22375.6 | 11 | 01/18/2025 |
| 7.0.0-preview.6.22324.4 | 13 | 03/07/2024 |
| 7.0.0-preview.5.22301.12 | 13 | 03/02/2024 |
| 7.0.0-preview.4.22229.4 | 17 | 03/08/2024 |
| 7.0.0-preview.3.22175.4 | 14 | 03/07/2024 |
| 7.0.0-preview.2.22152.2 | 13 | 03/08/2024 |
| 7.0.0-preview.1.22076.8 | 16 | 03/07/2024 |
| 6.0.2 | 11 | 01/18/2025 |
| 6.0.2-mauipre.1.22102.15 | 14 | 03/17/2024 |
| 6.0.2-mauipre.1.22054.8 | 15 | 03/17/2024 |
| 6.0.1 | 20 | 01/14/2024 |
| 6.0.0 | 25 | 08/18/2023 |
| 6.0.0-rc.2.21480.5 | 15 | 03/17/2024 |
| 6.0.0-rc.1.21451.13 | 15 | 03/16/2024 |
| 6.0.0-preview.7.21377.19 | 14 | 03/10/2024 |
| 6.0.0-preview.6.21352.12 | 12 | 03/15/2024 |
| 6.0.0-preview.5.21301.5 | 14 | 03/11/2024 |
| 6.0.0-preview.4.21253.7 | 14 | 03/09/2024 |
| 6.0.0-preview.3.21201.4 | 14 | 11/08/2023 |
| 6.0.0-preview.2.21154.6 | 12 | 03/06/2024 |
| 6.0.0-preview.1.21102.12 | 15 | 03/08/2024 |
| 5.0.0 | 29 | 08/18/2023 |
| 5.0.0-rc.2.20475.5 | 13 | 03/17/2024 |
| 5.0.0-rc.1.20451.14 | 14 | 03/17/2024 |
| 5.0.0-preview.8.20407.11 | 14 | 03/10/2024 |
| 5.0.0-preview.7.20364.11 | 14 | 01/18/2025 |
| 5.0.0-preview.6.20305.6 | 14 | 03/11/2024 |
| 5.0.0-preview.5.20278.1 | 15 | 03/11/2024 |
| 5.0.0-preview.4.20251.6 | 13 | 03/02/2024 |
| 5.0.0-preview.3.20215.2 | 14 | 03/09/2024 |
| 5.0.0-preview.2.20160.3 | 17 | 03/09/2024 |
| 5.0.0-preview.1.20120.4 | 12 | 03/09/2024 |
| 3.1.32 | 19 | 02/26/2024 |
| 3.1.31 | 18 | 11/15/2023 |
| 3.1.30 | 15 | 01/02/2024 |
| 3.1.29 | 13 | 03/12/2024 |
| 3.1.28 | 22 | 02/02/2024 |
| 3.1.27 | 18 | 03/01/2024 |
| 3.1.26 | 19 | 03/15/2024 |
| 3.1.25 | 14 | 03/15/2024 |
| 3.1.24 | 12 | 03/12/2024 |
| 3.1.23 | 13 | 03/15/2024 |
| 3.1.22 | 15 | 03/06/2024 |
| 3.1.21 | 15 | 03/15/2024 |
| 3.1.20 | 14 | 03/15/2024 |
| 3.1.19 | 17 | 11/06/2023 |
| 3.1.18 | 20 | 03/01/2024 |
| 3.1.17 | 13 | 03/28/2024 |
| 3.1.16 | 13 | 03/14/2024 |
| 3.1.15 | 13 | 03/15/2024 |
| 3.1.14 | 13 | 03/14/2024 |
| 3.1.13 | 15 | 03/15/2024 |
| 3.1.12 | 14 | 03/12/2024 |
| 3.1.11 | 12 | 03/15/2024 |
| 3.1.10 | 14 | 03/15/2024 |
| 3.1.9 | 15 | 01/18/2024 |
| 3.1.8 | 14 | 01/07/2024 |
| 3.1.7 | 16 | 03/17/2024 |
| 3.1.6 | 13 | 01/19/2024 |
| 3.1.5 | 15 | 03/12/2024 |
| 3.1.4 | 26 | 08/18/2023 |
| 3.1.3 | 29 | 12/18/2023 |
| 3.1.2 | 21 | 08/18/2023 |
| 3.1.1 | 16 | 12/04/2023 |
| 3.1.0 | 17 | 11/15/2023 |
| 3.1.0-preview3.19553.2 | 14 | 03/08/2024 |
| 3.1.0-preview2.19525.4 | 14 | 03/09/2024 |
| 3.1.0-preview1.19506.1 | 12 | 03/08/2024 |
| 3.0.3 | 539 | 08/18/2023 |
| 3.0.2 | 13 | 03/01/2024 |
| 3.0.1 | 17 | 01/21/2024 |
| 3.0.0 | 15 | 03/06/2024 |
| 3.0.0-rc1.19456.10 | 11 | 01/18/2025 |
| 3.0.0-preview9.19423.4 | 13 | 03/11/2024 |
| 3.0.0-preview8.19405.4 | 14 | 03/10/2024 |
| 3.0.0-preview7.19362.4 | 11 | 02/27/2024 |
| 3.0.0-preview6.19304.6 | 14 | 03/10/2024 |
| 3.0.0-preview5.19227.9 | 14 | 03/10/2024 |
| 3.0.0-preview4.19216.2 | 15 | 03/09/2024 |
| 3.0.0-preview3.19153.1 | 12 | 03/02/2024 |
| 3.0.0-preview.19074.2 | 14 | 03/11/2024 |
| 3.0.0-preview.18572.1 | 15 | 03/09/2024 |
| 2.2.0 | 717 | 08/18/2023 |
| 2.2.0-preview3-35497 | 10 | 03/16/2024 |
| 2.2.0-preview2-35157 | 13 | 03/16/2024 |
| 2.2.0-preview1-35029 | 11 | 03/18/2024 |
| 2.1.1 | 462 | 08/18/2023 |
| 2.1.0 | 25 | 03/06/2024 |
| 2.1.0-rc1-final | 12 | 03/15/2024 |
| 2.1.0-preview2-final | 14 | 03/15/2024 |
| 2.1.0-preview1-final | 14 | 03/08/2024 |
| 2.0.2 | 15 | 03/15/2024 |
| 2.0.1 | 14 | 01/03/2024 |
| 2.0.0 | 494 | 08/18/2023 |
| 2.0.0-preview2-final | 15 | 03/06/2024 |
| 2.0.0-preview1-final | 13 | 03/15/2024 |
| 1.1.2 | 19 | 03/18/2024 |
| 1.1.1 | 546 | 08/18/2023 |
| 1.1.0 | 16 | 01/07/2024 |
| 1.1.0-preview1-final | 14 | 03/15/2024 |
| 1.0.2 | 13 | 03/06/2024 |
| 1.0.1 | 14 | 03/12/2024 |
| 1.0.0 | 15 | 03/01/2024 |
| 1.0.0-rc2-final | 15 | 03/15/2024 |
| 1.0.0-rc1-final | 14 | 03/16/2024 |