Microsoft.Extensions.Configuration 8.0.0

前缀已保留
.NET 6.0 此包针对.NET 6.0。此包与该框架或更高版本兼容。 .NET Standard 2.0 此包针对.NET Standard 2.0。此包与该框架或更高版本兼容。 .NET Framework 4.6.2 此包针对.NET Framework 4.6.2。此包与该框架或更高版本兼容。
此包有可用的较新预发布版本。
请查看下面的版本列表以获取详细信息。
dotnet add package Microsoft.Extensions.Configuration --version 8.0.0                

                    
                

            
NuGet\Install-Package Microsoft.Extensions.Configuration -Version 8.0.0
此命令旨在在Visual Studio的包管理器控制台中使用，因为它使用了NuGet模块的Install-Package版本。
<PackageReference Include="Microsoft.Extensions.Configuration" Version="8.0.0" />
对于支持PackageReference的项目，将此XML节点复制到项目文件中以引用此包。
paket add Microsoft.Extensions.Configuration --version 8.0.0                

                    
                

            
#r "nuget: Microsoft.Extensions.Configuration, 8.0.0"
#r指令可用于F# Interactive和Polyglot Notebooks。将此复制到交互工具或脚本的源代码中以引用此包。
// Install Microsoft.Extensions.Configuration as a Cake Addin
#addin nuget:?package=Microsoft.Extensions.Configuration&version=8.0.0

// Install Microsoft.Extensions.Configuration as a Cake Tool
#tool nuget:?package=Microsoft.Extensions.Configuration&version=8.0.0

关于

Microsoft.Extensions.Configuration 与 Microsoft.Extensions.Configuration.Abstractions 下的核心配置抽象结合，允许构建不同类型的配置提供程序，以便以 IConfiguration 的形式检索键/值对配置值。有许多内置配置提供程序实现，可以读取环境变量、内存中的集合、JSON、INI 或 XML 文件。除了内置的变体之外，还有更多由社区提供的库，用于与各种配置服务和其它数据源集成。

主要特性

  • 内存配置提供程序
  • 链式配置提供程序，用于将多个配置提供程序链接在一起。
  • 实现配置抽象接口的基类型，可用于实现其它配置提供程序。

使用方法

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"]);

主要类型

该库提供的主要类型包括

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

附加文档

反馈与贡献

Microsoft.Extensions.Configuration 作为开源软件发布，遵循 MIT 许可协议。欢迎提交错误报告和贡献至 GitHub 仓库。

产品 兼容的及额外计算的目标框架版本。
.NET net5.0 已计算。 net5.0-windows 已计算。 net6.0 兼容。 net6.0-android 已计算。 net6.0-ios 已计算。 net6.0-maccatalyst 已计算。 net6.0-macos 已计算。 net6.0-tvos 已计算。 net6.0-windows 已计算。 net7.0 兼容。 net7.0-android 已计算。 net7.0-ios 已计算。 net7.0-maccatalyst 已计算。 net7.0-macos 已计算。 net7.0-tvos 已计算。 net7.0-windows 已计算。 net8.0 兼容。 net8.0-android 已计算。 net8.0-browser 已计算。 net8.0-ios 已计算。 net8.0-maccatalyst 已计算。 net8.0-macos 已计算。 net8.0-tvos 已计算。 net8.0-windows 已计算。
.NET Core netcoreapp2.0 已计算。 netcoreapp2.1 已计算。 netcoreapp2.2 已计算。 netcoreapp3.0 已计算。 netcoreapp3.1 已计算。
.NET Standard netstandard2.0 兼容。 netstandard2.1 已计算。
.NET Framework net461 已计算。 net462 兼容。 net463 已计算。 net47 已计算。 net471 已计算。 net472 已计算。 net48 已计算。 net481 已计算。
MonoAndroid monoandroid 已计算。
MonoMac monomac 已计算。
MonoTouch monotouch 已计算。
Tizen tizen40 已计算。 tizen60 已计算。
Xamarin.iOS xamarinios 已计算。
Xamarin.Mac xamarinmac 已计算。
Xamarin.TVOS xamarintvos 已计算。
Xamarin.WatchOS xamarinwatchos 已计算。
兼容的目标框架
包含的目标框架（在包中）
了解更多关于 目标框架 和 .NET Standard。

NuGet 包 (5.6K)

显示依赖于 Microsoft.Extensions.Configuration 的前 5 个 NuGet 包

包 下载
Microsoft.Extensions.Configuration.FileExtensions

为 Microsoft.Extensions.Configuration 提供基于文件的配置提供程序的基础类，并为配置它们提供扩展方法。
Microsoft.Extensions.Configuration.Json

Microsoft.Extensions.Configuration 的 JSON 配置提供程序实现。此包允许您从 JSON 文件中读取应用程序的设置。您可以使用 IConfigurationBuilder 的 JsonConfigurationExtensions.AddJsonFile 扩展方法将 JSON 配置提供程序添加到配置构建器中。
Microsoft.Extensions.Configuration.EnvironmentVariables

Microsoft.Extensions.Configuration的环境变量配置提供程序实现。此包允许您从环境变量中读取配置参数。您可以使用 IConfigurationBuilder 上的 EnvironmentVariablesExtensions.AddEnvironmentVariables 扩展方法向配置构建器添加环境变量配置提供程序。
Microsoft.Extensions.Logging.Configuration

Microsoft.Extensions.Logging的配置支持。
Microsoft.Extensions.Configuration.CommandLine

Microsoft.Extensions.Configuration的命令行配置提供程序实现。此包允许您从应用程序的命令行参数中读取配置参数。您可以使用 CommandLineConfigurationExtensions.AddCommandLine 扩展方法在与 IConfigurationBuilder 上添加命令行配置提供程序。

GitHub 仓库 (521)

显示最依赖 Microsoft.Extensions.Configuration 的前5个流行的 GitHub 仓库

仓库 明星
dotnet/maui
.NET MAUI 是 .NET Multi-platform App UI，一个用于构建涵盖移动、平板和桌面原生设备应用程序的框架。
microsoft/semantic-kernel
快速轻松地将尖端 LLM 技术集成到您的应用程序中
bitwarden/server
Bitwarden 基础设施/后端（API、数据库、Docker 等）
dotnet/efcore
EF Core 是 .NET 的现代对象-数据库映射器。它支持 LINQ 查询、更改跟踪、更新和架构迁移。
App-vNext/Polly
Polly 是一个 .NET 弹性和瞬态故障处理的库，允许开发人员以流畅和线程安全的方式表达策略，例如重试、断路器、超时、隔板隔离和回退。从版本 6.0.1 开始，Polly 面向 .NET Standard 1.1 和 2.0+。
版本 下载 最后更新
9.0.0-preview.7.24405.7 2,315 8/13/2024
9.0.0-preview.6.24327.7 50,906 7/9/2024
9.0.0-preview.5.24306.7 56,490 6/11/2024
9.0.0-preview.4.24266.19 50,054 5/21/2024
9.0.0-preview.3.24172.9 131,921 4/11/2024
9.0.0-preview.2.24128.5 63,799 3/12/2024
9.0.0-preview.1.24080.9 92,623 2/13/2024
8.0.0 86,459,139 11/14/2023
8.0.0-rc.2.23479.6 561,422 10/10/2023
8.0.0-rc.1.23419.4 365,536 9/12/2023
8.0.0-preview.7.23375.6 214,926 8/8/2023
8.0.0-preview.6.23329.7 162,660 7/11/2023
8.0.0-preview.5.23280.8 119,461 6/13/2023
8.0.0-preview.4.23259.5 260,680 5/16/2023
8.0.0-preview.3.23174.8 201,184 4/11/2023
8.0.0-preview.2.23128.3 200,034 3/14/2023
8.0.0-preview.1.23110.8 149,702 2/21/2023
7.0.0 130,360,058 11/7/2022
7.0.0-rc.2.22472.3 296,510 10/11/2022
7.0.0-rc.1.22426.10 244,352 9/14/2022
7.0.0-preview.7.22375.6 237,793 8/9/2022
7.0.0-preview.6.22324.4 132,941 7/12/2022
7.0.0-preview.5.22301.12 82,775 6/14/2022
7.0.0-preview.4.22229.4 199,708 5/10/2022
7.0.0-preview.3.22175.4 91,720 4/13/2022
7.0.0-preview.2.22152.2 105,479 3/14/2022
7.0.0-preview.1.22076.8 98,139 2/17/2022
6.0.1 106,891,662 3/8/2022
6.0.0 255,375,529 11/8/2021
6.0.0-rc.2.21480.5 612,526 10/12/2021
6.0.0-rc.1.21451.13 404,646 9/14/2021
6.0.0-preview.7.21377.19 239,485 8/10/2021
6.0.0-preview.6.21352.12 152,831 7/14/2021
6.0.0-preview.5.21301.5 109,081 6/15/2021
6.0.0-preview.4.21253.7 86,366 5/24/2021
6.0.0-preview.3.21201.4 252,353 4/8/2021
6.0.0-preview.2.21154.6 138,156 3/11/2021 6.0.0-preview.2.21154.6 已弃用，因为不再维护。
6.0.0-preview.1.21102.12 180,508 2/12/2021 6.0.0-preview.1.21102.12 已弃用，因为不再维护。
5.0.0 216,141,000 11/9/2020 5.0.0 已弃用，因为不再维护。
5.0.0-rc.2.20475.5 288,954 10/13/2020 5.0.0-rc.2.20475.5 已弃用，因为不再维护。
5.0.0-rc.1.20451.14 374,659 9/14/2020 5.0.0-rc.1.20451.14 已弃用，因为不再维护。
5.0.0-preview.8.20407.11 328,779 8/25/2020 5.0.0-preview.8.20407.11 已弃用，因为不再维护。
5.0.0-preview.7.20364.11 333,303 7/21/2020 5.0.0-preview.7.20364.11 已弃用，因为不再维护。
5.0.0-preview.6.20305.6 82,522 6/25/2020 5.0.0-preview.6.20305.6 已弃用，因为不再维护。
5.0.0-preview.5.20278.1 271,212 6/10/2020 5.0.0-preview.5.20278.1 已弃用，因为不再维护。
5.0.0-preview.4.20251.6 144,525 5/18/2020 5.0.0-preview.4.20251.6 已弃用，因为不再维护。
5.0.0-preview.3.20215.2 290,192 4/23/2020 5.0.0-preview.3.20215.2 已弃用，因为不再维护。
5.0.0-preview.2.20160.3 311,964 4/2/2020 5.0.0-preview.2.20160.3 已弃用，因为不再维护。
5.0.0-preview.1.20120.4 122,378 3/16/2020 5.0.0-preview.1.20120.4 已弃用，因为不再维护。
3.1.32 9,189,827 12/13/2022
3.1.31 1,902,752 11/8/2022
3.1.30 2,591,612 10/11/2022
3.1.29 2,091,388 9/13/2022
3.1.28 2,319,884 8/9/2022
3.1.27 1,892,958 7/12/2022
3.1.26 1,669,812 6/14/2022
3.1.25 2,810,005 5/10/2022
3.1.24 9,258,864 4/11/2022
3.1.23 4,397,728 3/8/2022
3.1.22 18,355,580 12/14/2021
3.1.21 9,300,388 11/7/2021
3.1.20 4,966,533 10/11/2021
3.1.19 5,471,393 9/14/2021
3.1.18 38,257,654 8/10/2021
3.1.17 6,832,990 7/13/2021
3.1.16 10,545,528 6/8/2021
3.1.15 8,625,642 5/11/2021
3.1.14 16,049,052 4/6/2021
3.1.13 15,243,295 3/9/2021
3.1.12 11,773,251 2/9/2021
3.1.11 13,590,272 1/12/2021
3.1.10 27,282,034 11/9/2020
3.1.9 68,455,763 10/13/2020
3.1.8 64,762,999 9/8/2020
3.1.7 35,264,571 8/11/2020
3.1.6 40,223,641 7/14/2020
3.1.5 43,002,682 6/9/2020
3.1.4 43,235,315 5/12/2020
3.1.3 87,439,118 3/24/2020
3.1.2 75,153,082 2/18/2020
3.1.1 42,578,793 1/14/2020
3.1.0 229,885,600 12/3/2019
3.1.0-preview3.19553.2 231,311 11/13/2019 3.1.0-preview3.19553.2 已弃用，因为不再维护。
3.1.0-preview2.19525.4 82,921 11/1/2019 3.1.0-preview2.19525.4 已弃用，因为不再维护。
3.1.0-preview1.19506.1 1,150,338 10/15/2019 3.1.0-preview1.19506.1 已弃用，因为不再维护。
3.0.3 59,279,306 2/18/2020 3.0.3 已弃用，因为不再维护。
3.0.2 1,097,246 1/14/2020 3.0.2 已弃用，因为不再维护。
3.0.1 6,914,206 11/18/2019 3.0.1 已弃用，因为不再维护。
3.0.0 87,995,368 9/23/2019 3.0.0 已弃用，因为不再维护。
3.0.0-rc1.19456.10 101,020 9/16/2019 3.0.0-rc1.19456.10 已弃用，因为不再维护。
3.0.0-preview9.19423.4 1,534,358 9/4/2019 3.0.0-preview9.19423.4 已弃用，因为不再维护。
3.0.0-preview8.19405.4 564,440 8/13/2019 3.0.0-preview8.19405.4 已弃用，因为不再维护。
3.0.0-preview7.19362.4 331,302 7/23/2019 3.0.0-preview7.19362.4 已弃用，因为不再维护。
3.0.0-preview6.19304.6 774,972 6/12/2019 3.0.0-preview6.19304.6 已弃用，因为不再维护。
3.0.0-preview5.19227.9 835,346 5/6/2019 3.0.0-preview5.19227.9 已弃用，因为不再维护。
3.0.0-preview4.19216.2 91,455 4/18/2019 3.0.0-preview4.19216.2 已弃用，因为不再维护。
3.0.0-preview3.19153.1 383,396 3/6/2019 3.0.0-preview3.19153.1 已弃用，因为不再维护。
3.0.0-preview.19074.2 246,019 1/29/2019 3.0.0-preview.19074.2 已淘汰，因为它不再维护。
3.0.0-preview.18572.1 179,272 12/4/2018 3.0.0-preview.18572.1 已淘汰，因为它不再维护。
2.2.0 252,301,137 12/3/2018 2.2.0 已淘汰，因为它不再维护。
2.2.0-preview3-35497 516,285 10/17/2018 2.2.0-preview3-35497 已淘汰，因为它不再维护。
2.2.0-preview2-35157 320,256 9/12/2018 2.2.0-preview2-35157 已淘汰，因为它不再维护。
2.2.0-preview1-35029 200,471 8/22/2018 2.2.0-preview1-35029 已淘汰，因为它不再维护。
2.1.1 343,503,585 6/18/2018
2.1.0 364,957,792 5/29/2018
2.1.0-rc1-final 561,037 5/6/2018 2.1.0-rc1-final 已淘汰，因为它不再维护。
2.1.0-preview2-final 651,836 4/10/2018 2.1.0-preview2-final 已淘汰，因为它不再维护。
2.1.0-preview1-final 644,130 2/26/2018 2.1.0-preview1-final 已淘汰，因为它不再维护。
2.0.2 34,408,153 5/7/2018 2.0.2 已淘汰，因为它不再维护。
2.0.1 19,697,041 3/13/2018 2.0.1 已淘汰，因为它不再维护。
2.0.0 351,824,317 8/11/2017 2.0.0 已淘汰，因为它不再维护。
2.0.0-preview2-final 287,793 6/28/2017 2.0.0-preview2-final 已淘汰，因为它不再维护。
2.0.0-preview1-final 1,134,265 5/10/2017 2.0.0-preview1-final 已弃用，因为不再维护。
1.1.2 29,800,984 5/9/2017 1.1.2 已弃用，因为不再维护。
1.1.1 9,441,672 3/6/2017 1.1.1 已弃用，因为不再维护。
1.1.0 6,048,234 11/16/2016 1.1.0 已弃用，因为不再维护。
1.1.0-preview1-final 64,820 10/24/2016 1.1.0-preview1-final 已弃用，因为不再维护。
1.0.2 80,145,965 3/6/2017 1.0.2 已弃用，因为不再维护。
1.0.1 3,748,869 12/12/2016 1.0.1 已弃用，因为不再维护。
1.0.0 20,569,859 6/27/2016 1.0.0 已弃用，因为不再维护。
1.0.0-rc2-final 1,838,513 5/16/2016 1.0.0-rc2-final 已弃用，因为不再维护。
1.0.0-rc1-final 847,869 11/18/2015 1.0.0-rc1-final 已弃用，因为不再维护。

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