.NET Core 配置管理器读取一个字典，其中有一个键里面有一个冒号，给出一个关于值的奇怪错误消息，这是预期的吗?

Question

以下程序：

using System;
using System.Collections.Generic;
using Microsoft.Extensions.Configuration;
namespace ConsoleApp3
{
class Program
{
static void Main()
{
var builder = new ConfigurationBuilder();
builder.AddJsonFile("appsettings.json");
var configuration = builder.Build();
var options = configuration.Get<Options>();
foreach (var kvp in options.Values)
Console.WriteLine($"{kvp.Key}: {kvp.Value}");
}
}
internal class Options
{
public Dictionary<string, bool> Values { get; } = new Dictionary<string, bool>();
}
}

当给定此appsettings.json文件时，可以完美运行：

{
"Values": {
"a": true,
"b": false
}
}

但是将appsettings.json内容更改为：

{
"Values": {
"a:b": true,
"b": false
}
}

我得到这个例外：

未处理的异常：System.InvalidOperationException：无法创建类型为"System.Boolean"的实例，因为它缺少公共无参数构造函数。

堆栈跟踪：

at Microsoft.Extensions.Configuration.ConfigurationBinder.CreateInstance(Type type)
at Microsoft.Extensions.Configuration.ConfigurationBinder.BindInstance(Type type, Object instance, IConfiguration config, BinderOptions options)
at Microsoft.Extensions.Configuration.ConfigurationBinder.BindDictionary(Object dictionary, Type dictionaryType, IConfiguration config, BinderOptions options)
at Microsoft.Extensions.Configuration.ConfigurationBinder.BindInstance(Type type, Object instance, IConfiguration config, BinderOptions options)
at Microsoft.Extensions.Configuration.ConfigurationBinder.BindProperty(PropertyInfo property, Object instance, IConfiguration config, BinderOptions options)
at Microsoft.Extensions.Configuration.ConfigurationBinder.BindNonScalar(IConfiguration configuration, Object instance, BinderOptions options)
at Microsoft.Extensions.Configuration.ConfigurationBinder.BindInstance(Type type, Object instance, IConfiguration config, BinderOptions options)
at Microsoft.Extensions.Configuration.ConfigurationBinder.Get[T](IConfiguration configuration, Action`1 configureOptions)
at ConsoleApp3.Program.Main() in D:DevConsoleApp3ConsoleApp3Program.cs:line 15

我做错了什么？请注意，在密钥中包含冒号是完全合法的 json，但也许不支持在 appsettings.json 文件中存储任何奇怪的字典？

Answer 1

ASP.NET 核心中的参考配置：分层配置数据

配置

API 能够通过在配置键中使用分隔符平展分层数据来维护分层配置数据。

将文件读入配置时，将创建唯一键以维护配置源的原始分层数据结构。部分和键使用冒号(:)压平以保持原始结构

这意味着在以下appsettings.json文件中

{
"Values": {
"a:b": true,
"b": false
}
}

键将被展平为

• 值：a：b
• 值：b

当ConfigurationBinder.BindDictionary尝试绑定Dictionary<string, bool>属性时，这将破坏设置文件的结构Options

还引用此 GitHub 问题

冒号是为键中的特殊含义保留的，因此它们不应用作正常键值的一部分。