Microsoft.Extensions.Configuration
9.0.11
Prefix Reserved
See the version list below for details.
dotnet add package Microsoft.Extensions.Configuration --version 9.0.11
NuGet\Install-Package Microsoft.Extensions.Configuration -Version 9.0.11
<PackageReference Include="Microsoft.Extensions.Configuration" Version="9.0.11" />
<PackageVersion Include="Microsoft.Extensions.Configuration" Version="9.0.11" />
<PackageReference Include="Microsoft.Extensions.Configuration" />
paket add Microsoft.Extensions.Configuration --version 9.0.11
#r "nuget: Microsoft.Extensions.Configuration, 9.0.11"
#:package Microsoft.Extensions.Configuration@9.0.11
#addin nuget:?package=Microsoft.Extensions.Configuration&version=9.0.11
#tool nuget:?package=Microsoft.Extensions.Configuration&version=9.0.11
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.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net5.0 was computed. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 is compatible. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net10.0 was computed. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
| .NET Core | netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
| .NET Standard | netstandard2.0 is compatible. netstandard2.1 was computed. |
| .NET Framework | net461 was computed. net462 is compatible. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed. |
| MonoAndroid | monoandroid was computed. |
| MonoMac | monomac was computed. |
| MonoTouch | monotouch was computed. |
| Tizen | tizen40 was computed. tizen60 was computed. |
| Xamarin.iOS | xamarinios was computed. |
| Xamarin.Mac | xamarinmac was computed. |
| Xamarin.TVOS | xamarintvos was computed. |
| Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETFramework 4.6.2
- Microsoft.Extensions.Configuration.Abstractions (>= 9.0.11)
- Microsoft.Extensions.Primitives (>= 9.0.11)
-
.NETStandard 2.0
- Microsoft.Extensions.Configuration.Abstractions (>= 9.0.11)
- Microsoft.Extensions.Primitives (>= 9.0.11)
-
net8.0
- Microsoft.Extensions.Configuration.Abstractions (>= 9.0.11)
- Microsoft.Extensions.Primitives (>= 9.0.11)
-
net9.0
- Microsoft.Extensions.Configuration.Abstractions (>= 9.0.11)
- Microsoft.Extensions.Primitives (>= 9.0.11)
NuGet packages (7.2K)
Showing the top 5 NuGet packages that depend on Microsoft.Extensions.Configuration:
| Package | Downloads |
|---|---|
|
Microsoft.Extensions.Configuration.Binder
Provides the functionality to bind an object to data in configuration providers for Microsoft.Extensions.Configuration. This package enables you to represent the configuration data as strongly-typed classes defined in the application code. To bind a configuration, use the Microsoft.Extensions.Configuration.ConfigurationBinder.Get extension method on the IConfiguration object. To use this package, you also need to install a package for the configuration provider, for example, Microsoft.Extensions.Configuration.Json for the JSON provider. |
|
|
Microsoft.Extensions.Configuration.FileExtensions
Provides a base class for file-based configuration providers used with Microsoft.Extensions.Configuration and extension methods for configuring them. |
|
|
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. |
|
|
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. |
|
|
Microsoft.Extensions.Logging.Configuration
Configuration support for Microsoft.Extensions.Logging. |
GitHub repositories (632)
Showing the top 20 popular GitHub repositories that depend on Microsoft.Extensions.Configuration:
| Repository | Stars |
|---|---|
|
microsoft/semantic-kernel
Integrate cutting-edge LLM technology quickly and easily into your apps
|
|
|
icsharpcode/ILSpy
.NET Decompiler with support for PDB generation, ReadyToRun, Metadata (&more) - cross-platform!
|
|
|
dotnet/maui
.NET MAUI is the .NET Multi-platform App UI, a framework for building native device applications spanning mobile, tablet, and desktop.
|
|
|
dotnet/roslyn
The Roslyn .NET compiler provides C# and Visual Basic languages with rich code analysis APIs.
|
|
|
ardalis/CleanArchitecture
Clean Architecture Solution Template: A proven Clean Architecture Template for ASP.NET Core 10
|
|
|
bitwarden/server
Bitwarden infrastructure/backend (API, database, Docker, etc).
|
|
|
dotnet/efcore
EF Core is a modern object-database mapper for .NET. It supports LINQ queries, change tracking, updates, and schema migrations.
|
|
|
Jackett/Jackett
API Support for your favorite torrent trackers
|
|
|
App-vNext/Polly
Polly is a .NET resilience and transient-fault-handling library that allows developers to express policies such as Retry, Circuit Breaker, Timeout, Bulkhead Isolation, and Fallback in a fluent and thread-safe manner. From version 6.0.1, Polly targets .NET Standard 1.1 and 2.0+.
|
|
|
dotnet/AspNetCore.Docs
Documentation for ASP.NET Core
|
|
|
Sonarr/Sonarr
Smart PVR for newsgroup and bittorrent users.
|
|
|
Radarr/Radarr
Movie organizer/manager for usenet and torrent users.
|
|
|
d2phap/ImageGlass
🏞 A lightweight, versatile image viewer
|
|
|
chocolatey/choco
Chocolatey - the package manager for Windows
|
|
|
dotnet/orleans
Cloud Native application framework for .NET
|
|
|
Tyrrrz/DiscordChatExporter
Saves Discord chat logs to a file
|
|
|
JeffreySu/WeiXinMPSDK
微信全平台 .NET SDK, Senparc.Weixin for C#,支持 .NET Framework 及 .NET Core、.NET 10.0。已支持微信公众号、小程序、小游戏、微信支付、企业微信/企业号、开放平台、JSSDK、微信周边等全平台。 WeChat SDK for C#.
|
|
|
ThreeMammals/Ocelot
.NET API Gateway
|
|
|
RayWangQvQ/BiliBiliToolPro
B 站(bilibili)自动任务工具,支持docker、青龙、k8s等多种部署方式。敏感肌也能用。
|
|
|
microsoft/ailab
Experience, Learn and Code the latest breakthrough innovations with Microsoft AI
|
| Version | Downloads | Last Updated | |
|---|---|---|---|
| 10.0.0 | 1,192,174 | 11/11/2025 | |
| 10.0.0-rc.2.25502.107 | 253,850 | 10/14/2025 | |
| 10.0.0-rc.1.25451.107 | 290,592 | 9/9/2025 | |
| 10.0.0-preview.7.25380.108 | 101,377 | 8/12/2025 | |
| 10.0.0-preview.6.25358.103 | 105,953 | 7/15/2025 | |
| 10.0.0-preview.5.25277.114 | 139,708 | 6/6/2025 | |
| 10.0.0-preview.4.25258.110 | 90,007 | 5/12/2025 | |
| 10.0.0-preview.3.25171.5 | 126,059 | 4/10/2025 | |
| 10.0.0-preview.2.25163.2 | 82,387 | 3/18/2025 | |
| 10.0.0-preview.1.25080.5 | 191,615 | 2/25/2025 | |
| 9.0.11 | 486,278 | 11/11/2025 | |
| 9.0.10 | 5,861,571 | 10/14/2025 | |
| 9.0.9 | 10,617,914 | 9/9/2025 | |
| 9.0.8 | 12,208,075 | 8/4/2025 | |
| 9.0.7 | 10,275,906 | 7/8/2025 | |
| 9.0.6 | 11,830,278 | 6/10/2025 | |
| 9.0.5 | 15,994,827 | 5/13/2025 | |
| 9.0.4 | 19,925,468 | 4/8/2025 | |
| 9.0.3 | 16,526,537 | 3/11/2025 | |
| 9.0.2 | 17,679,850 | 2/11/2025 | |
| 9.0.1 | 19,508,736 | 1/14/2025 | |
| 9.0.0 | 85,593,967 | 11/12/2024 | |
| 9.0.0-rc.2.24473.5 | 478,295 | 10/8/2024 | |
| 9.0.0-rc.1.24431.7 | 380,950 | 9/10/2024 | |
| 9.0.0-preview.7.24405.7 | 190,528 | 8/13/2024 | |
| 9.0.0-preview.6.24327.7 | 285,625 | 7/9/2024 | |
| 9.0.0-preview.5.24306.7 | 173,863 | 6/11/2024 | |
| 9.0.0-preview.4.24266.19 | 230,824 | 5/21/2024 | |
| 9.0.0-preview.3.24172.9 | 257,105 | 4/11/2024 | |
| 9.0.0-preview.2.24128.5 | 163,085 | 3/12/2024 | |
| 9.0.0-preview.1.24080.9 | 175,269 | 2/13/2024 | |
| 8.0.0 | 444,802,341 | 11/14/2023 | |
| 8.0.0-rc.2.23479.6 | 882,349 | 10/10/2023 | |
| 8.0.0-rc.1.23419.4 | 827,661 | 9/12/2023 | |
| 8.0.0-preview.7.23375.6 | 313,379 | 8/8/2023 | |
| 8.0.0-preview.6.23329.7 | 220,876 | 7/11/2023 | |
| 8.0.0-preview.5.23280.8 | 230,720 | 6/13/2023 | |
| 8.0.0-preview.4.23259.5 | 411,104 | 5/16/2023 | |
| 8.0.0-preview.3.23174.8 | 298,562 | 4/11/2023 | |
| 8.0.0-preview.2.23128.3 | 244,742 | 3/14/2023 | |
| 8.0.0-preview.1.23110.8 | 170,377 | 2/21/2023 | |
| 7.0.0 | 189,953,213 | 11/7/2022 | |
| 7.0.0-rc.2.22472.3 | 349,926 | 10/11/2022 | |
| 7.0.0-rc.1.22426.10 | 283,291 | 9/14/2022 | |
| 7.0.0-preview.7.22375.6 | 259,078 | 8/9/2022 | |
| 7.0.0-preview.6.22324.4 | 159,763 | 7/12/2022 | |
| 7.0.0-preview.5.22301.12 | 93,883 | 6/14/2022 | |
| 7.0.0-preview.4.22229.4 | 229,735 | 5/10/2022 | |
| 7.0.0-preview.3.22175.4 | 105,816 | 4/13/2022 | |
| 7.0.0-preview.2.22152.2 | 119,877 | 3/14/2022 | |
| 7.0.0-preview.1.22076.8 | 105,331 | 2/17/2022 | |
| 6.0.2 | 2,961,481 | 11/12/2024 | |
| 6.0.1 | 175,066,999 | 3/8/2022 | |
| 6.0.0 | 355,915,195 | 11/8/2021 | |
| 6.0.0-rc.2.21480.5 | 665,187 | 10/12/2021 | |
| 6.0.0-rc.1.21451.13 | 454,232 | 9/14/2021 | |
| 6.0.0-preview.7.21377.19 | 256,890 | 8/10/2021 | |
| 6.0.0-preview.6.21352.12 | 161,617 | 7/14/2021 | |
| 6.0.0-preview.5.21301.5 | 116,123 | 6/15/2021 | |
| 6.0.0-preview.4.21253.7 | 94,971 | 5/24/2021 | |
| 6.0.0-preview.3.21201.4 | 290,437 | 4/8/2021 | |
| 6.0.0-preview.2.21154.6 | 160,372 | 3/11/2021 | |
| 6.0.0-preview.1.21102.12 | 198,318 | 2/12/2021 | |
| 5.0.0 | 282,898,270 | 11/9/2020 | |
| 5.0.0-rc.2.20475.5 | 317,311 | 10/13/2020 | |
| 5.0.0-rc.1.20451.14 | 385,871 | 9/14/2020 | |
| 5.0.0-preview.8.20407.11 | 393,964 | 8/25/2020 | |
| 5.0.0-preview.7.20364.11 | 354,900 | 7/21/2020 | |
| 5.0.0-preview.6.20305.6 | 87,589 | 6/25/2020 | |
| 5.0.0-preview.5.20278.1 | 432,850 | 6/10/2020 | |
| 5.0.0-preview.4.20251.6 | 157,636 | 5/18/2020 | |
| 5.0.0-preview.3.20215.2 | 304,383 | 4/23/2020 | |
| 5.0.0-preview.2.20160.3 | 329,815 | 4/2/2020 | |
| 5.0.0-preview.1.20120.4 | 128,757 | 3/16/2020 | |
| 3.1.32 | 20,952,120 | 12/13/2022 | |
| 3.1.31 | 3,536,900 | 11/8/2022 | |
| 3.1.30 | 3,602,634 | 10/11/2022 | |
| 3.1.29 | 3,582,671 | 9/13/2022 | |
| 3.1.28 | 3,050,778 | 8/9/2022 | |
| 3.1.27 | 2,483,296 | 7/12/2022 | |
| 3.1.26 | 2,133,309 | 6/14/2022 | |
| 3.1.25 | 3,594,493 | 5/10/2022 | |
| 3.1.24 | 15,103,208 | 4/11/2022 | |
| 3.1.23 | 5,217,416 | 3/8/2022 | |
| 3.1.22 | 26,364,108 | 12/14/2021 | |
| 3.1.21 | 12,029,327 | 11/7/2021 | |
| 3.1.20 | 6,696,079 | 10/11/2021 | |
| 3.1.19 | 6,303,422 | 9/14/2021 | |
| 3.1.18 | 49,477,001 | 8/10/2021 | |
| 3.1.17 | 7,890,897 | 7/13/2021 | |
| 3.1.16 | 12,107,439 | 6/8/2021 | |
| 3.1.15 | 9,867,202 | 5/11/2021 | |
| 3.1.14 | 18,711,882 | 4/6/2021 | |
| 3.1.13 | 17,442,183 | 3/9/2021 | |
| 3.1.12 | 13,516,018 | 2/9/2021 | |
| 3.1.11 | 15,808,895 | 1/12/2021 | |
| 3.1.10 | 30,719,067 | 11/9/2020 | |
| 3.1.9 | 84,021,923 | 10/13/2020 | |
| 3.1.8 | 74,347,061 | 9/8/2020 | |
| 3.1.7 | 42,328,921 | 8/11/2020 | |
| 3.1.6 | 47,063,071 | 7/14/2020 | |
| 3.1.5 | 50,117,849 | 6/9/2020 | |
| 3.1.4 | 54,481,777 | 5/12/2020 | |
| 3.1.3 | 122,402,292 | 3/24/2020 | |
| 3.1.2 | 86,369,055 | 2/18/2020 | |
| 3.1.1 | 48,009,559 | 1/14/2020 | |
| 3.1.0 | 381,255,534 | 12/3/2019 | |
| 3.1.0-preview3.19553.2 | 245,379 | 11/13/2019 | |
| 3.1.0-preview2.19525.4 | 86,127 | 11/1/2019 | |
| 3.1.0-preview1.19506.1 | 1,238,713 | 10/15/2019 | |
| 3.0.3 | 89,628,832 | 2/18/2020 | |
| 3.0.2 | 1,190,928 | 1/14/2020 | |
| 3.0.1 | 7,647,844 | 11/18/2019 | |
| 3.0.0 | 101,972,082 | 9/23/2019 | |
| 3.0.0-rc1.19456.10 | 104,287 | 9/16/2019 | |
| 3.0.0-preview9.19423.4 | 1,618,546 | 9/4/2019 | |
| 3.0.0-preview8.19405.4 | 635,509 | 8/13/2019 | |
| 3.0.0-preview7.19362.4 | 356,753 | 7/23/2019 | |
| 3.0.0-preview6.19304.6 | 838,729 | 6/12/2019 | |
| 3.0.0-preview5.19227.9 | 909,410 | 5/6/2019 | |
| 3.0.0-preview4.19216.2 | 95,211 | 4/18/2019 | |
| 3.0.0-preview3.19153.1 | 407,093 | 3/6/2019 | |
| 3.0.0-preview.19074.2 | 260,780 | 1/29/2019 | |
| 3.0.0-preview.18572.1 | 197,174 | 12/4/2018 | |
| 2.2.0 | 325,651,049 | 12/3/2018 | |
| 2.2.0-preview3-35497 | 541,583 | 10/17/2018 | |
| 2.2.0-preview2-35157 | 348,526 | 9/12/2018 | |
| 2.2.0-preview1-35029 | 209,066 | 8/22/2018 | |
| 2.1.1 | 539,350,009 | 6/18/2018 | |
| 2.1.0 | 518,421,329 | 5/29/2018 | |
| 2.1.0-rc1-final | 645,037 | 5/6/2018 | |
| 2.1.0-preview2-final | 711,350 | 4/10/2018 | |
| 2.1.0-preview1-final | 686,204 | 2/26/2018 | |
| 2.0.2 | 50,882,348 | 5/7/2018 | |
| 2.0.1 | 23,761,003 | 3/13/2018 | |
| 2.0.0 | 425,743,460 | 8/11/2017 | |
| 2.0.0-preview2-final | 354,028 | 6/28/2017 | |
| 2.0.0-preview1-final | 1,185,598 | 5/10/2017 | |
| 1.1.2 | 40,641,861 | 5/9/2017 | |
| 1.1.1 | 10,514,918 | 3/6/2017 | |
| 1.1.0 | 6,564,354 | 11/16/2016 | |
| 1.1.0-preview1-final | 67,040 | 10/24/2016 | |
| 1.0.2 | 85,043,245 | 3/6/2017 | |
| 1.0.1 | 3,889,387 | 12/12/2016 | |
| 1.0.0 | 23,223,164 | 6/27/2016 | |
| 1.0.0-rc2-final | 1,853,933 | 5/16/2016 | |
| 1.0.0-rc1-final | 885,390 | 11/18/2015 |