ASP.NET Core怎么读取配置文件 IConfiguration使用方法_技术教程

ASP.NET Core 通过 IConfiguration 统一读取多源配置，依赖注入 + 强类型绑定是推荐方式；默认加载 appsettings.json、环境变量等，Program.cs 中 WebApplicationBuilder.Configuration 开箱即用，服务中应注入 IConfiguration 或 IOptions 而非手动解析。

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("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(builder.Configuration.GetSection("ApiSettings"));

然后在服务中注入 IOptions：

public class MyService
{
    private readonly ApiSettings _apiSettings;

    public MyService(IOptions options)
    {
        _apiSettings = options.Value; // 或 IOptionsSnapshot 获取当前快照
    }
}

这样支持验证、重载（配合 IOptionsMonitor）、单元测试，也避免硬编码字符串键。