.NET Core 通过 Microsoft.Extensions.Configuration.Xml 包支持 XML 配置文件,如 appsettings.xml,其 key 属性支持冒号分隔的层级路径(如 Logging:LogLevel:Default),自动映射为 IConfiguration 树结构;自定义 XML 结构需手动解析后通过 AddInMemoryCollection 注入;配合 IOptions 使用方式与 JSON 完全一致。

.NET Core 本身不直接支持将 XML 文件作为主配置源(像 appsettings.json 那样开箱即用),但可以通过自定义 ConfigurationProvider 或借助第三方库(如 Serilog.Settings.XML)来读取 XML 配置。不过,最常用、最推荐的方式是:把 XML 配置转换为标准的 IConfiguration 树结构,再集成进 .NET Core 的配置系统。
使用 XmlConfigurationProvider(官方扩展包)
.NET Core 官方提供了 Microsoft.Extensions.Configuration.Xml 包,专门用于加载 XML 配置文件(如 appsettings.xml)。它支持层级映射,语法类似 JSON,但用 XML 标签表示。
- 安装 NuGet 包:
Microsoft.Extensions.Configuration.Xml - XML 文件示例(appsettings.xml):
注意:key 属性支持冒号分隔的层级路径(如 Logging:LogLevel:Default),会被自动解析为 IConfiguration 的嵌套节点。
- 在
Program.cs中加载:
builder.Configuration.AddXmlFile("appsettings.xml", optional: true, reloadOnChange: true);
自定义 XML 配置结构(非 appSettings 格式)
如果你的 XML 是自定义结构(比如带命名空间、复杂嵌套、属性+文本混合),官方 XmlConfigurationProvider 就不适用了。这时可手动解析 XML,再注入到 IConfiguration 中:
- 用
XDocument或XmlSerializer解析 XML 内容 - 将结果对象序列化为 Dictionary
(键为路径,值为字符串) - 调用
configuration.AddInMemoryCollection(dict)
例如,XML 中有 Database:Host → 值 localhost。
配合 IOptions 使用 XML 配置
只要 XML 被成功加载进 IConfiguration,后续使用 IOptions
- 定义配置类(Poco)
- 注册服务:
builder.Services.Configure(builder.Configuration.GetSection("MySection")); - 在控制器或服务中注入
IOptions即可
注意事项与常见问题
XML 加载不生效?检查这几项:
- 文件属性设为“复制到输出目录:始终复制”
- 确保 XML 格式合法(无未闭合标签、特殊字符已转义)
- key 路径中的冒号不能写错(如
Logging:Level≠Logging.Level) - 如果用了多个配置源,XML 的优先级默认低于命令行和环境变量
基本上就这些。不复杂但容易忽略细节 —— 关键是让 XML 的 key 结构匹配 IConfiguration 的层级约定。










