ASP.NET Core怎么读取配置文件 IConfiguration使用方法

来源:这里教程网 时间:2026-02-21 17:36:01 作者:

ASP.NET Core 通过

IConfiguration
接口统一读取各种来源的配置(如 appsettings.json、环境变量、命令行参数等),核心是依赖注入 + 配置绑定,不是手动解析文件。

配置自动注入到 Startup 或 Program 中

在 .NET 6+ 的最小托管模型(Program.cs)中,

WebApplicationBuilder.Configuration
就是已预配置好的
IConfiguration
实例,开箱即用:

它默认加载
appsettings.json
appsettings.{Environment}.json
、环境变量、命令行参数等
无需手动创建或调用
ConfigurationBuilder
,除非你有特殊需求(比如额外加自定义源)

在服务中使用 IConfiguration(推荐方式)

IConfiguration
作为构造函数参数注入,避免静态访问或全局实例:

public class MyService
{
    private readonly IConfiguration _config;
    public MyService(IConfiguration config)
    {
        _config = config;
    }
    public void DoWork()
    {
        string connStr = _config.GetConnectionString("DefaultConnection");
        string apiHost = _config["ApiSettings:Host"]; // 冒号表示层级(对应 JSON 中的嵌套对象)
        int timeout = _config.GetValue<int>("ApiSettings:Timeout", 30); // 带默认值
    }
}

注意:

_config["Section:Key"]
是最轻量的读取方式,适合简单场景;但更推荐类型安全的绑定。

用强类型对象绑定配置(更安全、可测试)

先定义 POCO 类(属性名需与配置键匹配):

public class ApiSettings
{
    public string Host { get; set; } = string.Empty;
    public int Timeout { get; set; } = 30;
    public bool EnableLogging { get; set; }
}

Program.cs
中注册绑定:

builder.Services.Configure<ApiSettings>(builder.Configuration.GetSection("ApiSettings"));

然后在服务中注入

IOptions<apisettings></apisettings>

public class MyService
{
    private readonly ApiSettings _apiSettings;
    public MyService(IOptions<ApiSettings> options)
    {
        _apiSettings = options.Value; // 或 IOptionsSnapshot 获取当前快照
    }
}

这样支持验证、重载(配合

IOptionsMonitor
)、单元测试,也避免硬编码字符串键。

常见配置源和优先级

默认顺序(后加载的覆盖前面同名项):

appsettings.json appsettings.{Environment}.json(如 Development / Production) 用户密钥(仅 Development,
dotnet user-secrets
环境变量(如
ApiSettings__Host=api.example.com
,双下划线代替冒号)
命令行参数(
--ApiSettings:Host api.example.com

所有来源最终都合并进同一个

IConfiguration
树,读取方式完全一致。

基本上就这些。不复杂但容易忽略的是:别直接 new ConfigurationBuilder,别用 static ConfigurationManager,坚持依赖注入 + 强类型绑定,配置就既清晰又可靠。

相关推荐