Microsoft.Extensions.Configuration 10.0.4

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
Steeltoe.Extensions.Configuration.CloudFoundryBase
CloudFoundry Environment Variable Configuration Provider - Base Package
34
Steeltoe.Extensions.Configuration.CloudFoundryBase
CloudFoundry Environment Variable Configuration Provider - Base Package
32
Microsoft.Extensions.Configuration.CommandLine
Command line configuration provider implementation for Microsoft.Extensions.Configuration.
31
Microsoft.Extensions.Configuration.FileExtensions
Extension methods for configuring file-based configuration providers for Microsoft.Extensions.Configuration.
29
Microsoft.Extensions.Configuration.FileExtensions
Extension methods for configuring file-based configuration providers for Microsoft.Extensions.Configuration.
28
Microsoft.ApplicationInsights.AspNetCore
Application Insights for ASP.NET Core web applications. See https://azure.microsoft.com/documentation/articles/app-insights-asp-net-five/ for more information. Privacy statement: https://go.microsoft.com/fwlink/?LinkId=512156
27
Dapr.Client
This package contains the reference assemblies for developing services using Dapr.
27
Microsoft.Extensions.Configuration.Binder
Functionality to bind an object to data in configuration providers for Microsoft.Extensions.Configuration.
25
Microsoft.Extensions.Configuration.KeyPerFile
Configuration provider that uses files in a directory for Microsoft.Extensions.Configuration. This package was built from the source code at https://github.com/dotnet/aspnetcore/tree/febee99db845fd8766a13bdb391a07c3ee90b4ba
25
Steeltoe.Extensions.Configuration.CloudFoundryBase
CloudFoundry Environment Variable Configuration Provider - Base Package
25
Microsoft.AspNetCore.App
Provides a default set of APIs for building an ASP.NET Core application. This package requires the ASP.NET Core runtime. This runtime is installed by the .NET Core SDK, or can be acquired separately using installers available at https://aka.ms/dotnet-download.
24
Microsoft.Extensions.Configuration.FileExtensions
Extension methods for configuring file-based configuration providers for Microsoft.Extensions.Configuration. When using NuGet 3.x this package requires at least version 3.4.
24
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/392e329b194b18c7cae04273479334d88c05af2c
24
Microsoft.Extensions.Configuration.CommandLine
Command line configuration provider implementation for Microsoft.Extensions.Configuration. This package was built from the source at: https://github.com/aspnet/Configuration/tree/55a0df253ae1fdf4065b6f54fa3e6bac07a3e196
24
Microsoft.Extensions.Configuration.KeyPerFile
Configuration provider that uses files in a directory for Microsoft.Extensions.Configuration. This package was built from the source code at https://github.com/dotnet/aspnetcore/tree/4ae1269bff83362236d0f3bd4c9302e6a1e9341c
24
Microsoft.Extensions.Configuration.Xml
XML configuration provider implementation for Microsoft.Extensions.Configuration. When using NuGet 3.x this package requires at least version 3.4.
24
Microsoft.ApplicationInsights.AspNetCore
Application Insights for ASP.NET Core web applications. See https://azure.microsoft.com/en-us/documentation/articles/app-insights-asp-net-five/ for more information. Privacy statement: https://go.microsoft.com/fwlink/?LinkId=512156
24
Microsoft.Extensions.Configuration.KeyPerFile
Configuration provider that uses files in a directory for Microsoft.Extensions.Configuration. This package was built from the source code at https://github.com/dotnet/aspnetcore/tree/c2a442982e736e17ae6bcadbfd8ccba278ee1be6
24
Microsoft.Extensions.Configuration.KeyPerFile
Configuration provider that uses files in a directory for Microsoft.Extensions.Configuration. This package was built from the source code at https://github.com/dotnet/aspnetcore/tree/0a715692d8e2536c899faa0bb4f0cec2c2e33e36
24
Dapr.Client
This package contains the reference assemblies for developing services using Dapr.
24

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

Version Downloads Last updated
11.0.0-preview.2.26159.112 4 3/13/2026
11.0.0-preview.1.26104.118 5 2/13/2026
10.0.5 2 3/12/2026
10.0.4 3 3/10/2026
10.0.3 4 2/11/2026
10.0.2 6 1/14/2026
10.0.1 8 12/14/2025
10.0.0 8 11/15/2025
10.0.0-rc.2.25502.107 7 10/18/2025
10.0.0-rc.1.25451.107 7 9/13/2025
10.0.0-preview.7.25380.108 7 8/16/2025
10.0.0-preview.6.25358.103 9 7/19/2025
10.0.0-preview.5.25277.114 4 6/9/2025
10.0.0-preview.4.25258.110 4 6/19/2025
10.0.0-preview.3.25171.5 3 6/8/2025
10.0.0-preview.2.25163.2 11 6/8/2025
10.0.0-preview.1.25080.5 3 6/8/2025
9.0.14 3 3/10/2026
9.0.13 3 2/11/2026
9.0.12 5 1/16/2026
9.0.11 6 11/15/2025
9.0.10 7 10/18/2025
9.0.9 10 9/13/2025
9.0.8 9 8/10/2025
9.0.7 10 7/13/2025
9.0.6 4 6/12/2025
9.0.5 3 6/16/2025
9.0.4 2 6/8/2025
9.0.3 4 6/8/2025
9.0.2 7 6/8/2025
9.0.1 5 6/8/2025
9.0.0 4 6/8/2025
9.0.0-rc.2.24473.5 3 6/8/2025
9.0.0-rc.1.24431.7 4 6/9/2025
9.0.0-preview.7.24405.7 16 6/8/2025
9.0.0-preview.6.24327.7 3 6/8/2025
9.0.0-preview.5.24306.7 3 6/8/2025
9.0.0-preview.4.24266.19 3 6/8/2025
9.0.0-preview.3.24172.9 1 6/8/2025
9.0.0-preview.2.24128.5 1 6/8/2025
9.0.0-preview.1.24080.9 2 6/8/2025
8.0.0 11 6/8/2025
8.0.0-rc.2.23479.6 4 6/8/2025
8.0.0-rc.1.23419.4 2 6/8/2025
8.0.0-preview.7.23375.6 3 6/8/2025
8.0.0-preview.6.23329.7 4 6/8/2025
8.0.0-preview.5.23280.8 2 6/8/2025
8.0.0-preview.4.23259.5 3 6/8/2025
8.0.0-preview.3.23174.8 2 6/8/2025
8.0.0-preview.2.23128.3 3 6/8/2025
8.0.0-preview.1.23110.8 2 6/8/2025
7.0.0 20 6/8/2025
7.0.0-rc.2.22472.3 22 6/8/2025
7.0.0-rc.1.22426.10 17 6/10/2025
7.0.0-preview.7.22375.6 15 6/8/2025
7.0.0-preview.6.22324.4 11 6/8/2025
7.0.0-preview.5.22301.12 18 6/8/2025
7.0.0-preview.4.22229.4 13 6/8/2025
7.0.0-preview.3.22175.4 18 6/8/2025
7.0.0-preview.2.22152.2 16 6/8/2025
7.0.0-preview.1.22076.8 19 6/8/2025
6.0.2 13 6/9/2025
6.0.1 12 6/8/2025
6.0.0 18 6/8/2025
6.0.0-rc.2.21480.5 20 6/8/2025
6.0.0-rc.1.21451.13 12 6/9/2025
6.0.0-preview.7.21377.19 12 6/8/2025
6.0.0-preview.6.21352.12 19 6/8/2025
6.0.0-preview.5.21301.5 12 6/8/2025
6.0.0-preview.4.21253.7 18 6/7/2025
6.0.0-preview.3.21201.4 19 6/8/2025
6.0.0-preview.2.21154.6 18 6/8/2025
6.0.0-preview.1.21102.12 20 6/8/2025
5.0.0 22 6/8/2025
5.0.0-rc.2.20475.5 18 6/8/2025
5.0.0-rc.1.20451.14 21 6/7/2025
5.0.0-preview.8.20407.11 19 6/8/2025
5.0.0-preview.7.20364.11 21 6/8/2025
5.0.0-preview.6.20305.6 17 6/8/2025
5.0.0-preview.5.20278.1 14 6/8/2025
5.0.0-preview.4.20251.6 16 6/8/2025
5.0.0-preview.3.20215.2 16 6/8/2025
5.0.0-preview.2.20160.3 14 6/8/2025
5.0.0-preview.1.20120.4 19 6/8/2025
3.1.32 12 6/8/2025
3.1.31 13 6/8/2025
3.1.30 18 6/8/2025
3.1.29 20 6/8/2025
3.1.28 20 6/8/2025
3.1.27 21 6/8/2025
3.1.26 21 6/8/2025
3.1.25 22 6/8/2025
3.1.24 17 6/8/2025
3.1.23 17 6/8/2025
3.1.22 13 6/8/2025
3.1.21 17 6/8/2025
3.1.20 20 6/8/2025
3.1.19 19 6/8/2025
3.1.18 21 6/8/2025
3.1.17 13 6/8/2025
3.1.16 20 6/9/2025
3.1.15 21 6/9/2025
3.1.14 19 6/8/2025
3.1.13 22 6/8/2025
3.1.12 20 6/8/2025
3.1.11 21 6/8/2025
3.1.10 22 6/8/2025
3.1.9 18 6/8/2025
3.1.8 15 6/8/2025
3.1.7 20 6/8/2025
3.1.6 23 6/8/2025
3.1.5 19 6/8/2025
3.1.4 23 6/8/2025
3.1.3 18 6/8/2025
3.1.2 19 6/8/2025
3.1.1 18 6/8/2025
3.1.0 20 6/8/2025
3.1.0-preview3.19553.2 19 6/8/2025
3.1.0-preview2.19525.4 21 6/8/2025
3.1.0-preview1.19506.1 14 6/8/2025
3.0.3 14 6/8/2025
3.0.2 22 6/8/2025
3.0.1 20 6/8/2025
3.0.0 27 6/7/2025
3.0.0-rc1.19456.10 14 6/8/2025
3.0.0-preview9.19423.4 18 6/8/2025
3.0.0-preview8.19405.4 21 6/8/2025
3.0.0-preview7.19362.4 12 6/8/2025
3.0.0-preview6.19304.6 20 6/8/2025
3.0.0-preview5.19227.9 19 6/8/2025
3.0.0-preview4.19216.2 12 6/8/2025
3.0.0-preview3.19153.1 12 6/8/2025
3.0.0-preview.19074.2 13 6/8/2025
3.0.0-preview.18572.1 14 6/8/2025
2.2.0 12 6/8/2025
2.2.0-preview3-35497 19 6/8/2025
2.2.0-preview2-35157 24 6/8/2025
2.2.0-preview1-35029 15 6/8/2025
2.1.1 18 6/8/2025
2.1.0 15 6/8/2025
2.1.0-rc1-final 13 6/8/2025
2.1.0-preview2-final 23 6/8/2025
2.1.0-preview1-final 21 6/8/2025
2.0.2 21 6/9/2025
2.0.1 17 6/8/2025
2.0.0 20 6/8/2025
2.0.0-preview2-final 13 6/8/2025
2.0.0-preview1-final 12 6/8/2025
1.1.2 16 6/8/2025
1.1.1 22 6/8/2025
1.1.0 23 6/7/2025
1.1.0-preview1-final 21 6/8/2025
1.0.2 22 6/8/2025
1.0.1 23 6/8/2025
1.0.0 16 6/8/2025
1.0.0-rc2-final 15 6/8/2025
1.0.0-rc1-final 17 6/8/2025