ASP.NET Core能否一次性将整个appsettings.json读取至单个类中？

你想要的这种通过单个顶层类统一加载所有配置节的方式不仅可行，而且是.NET配置系统设计时就支持的最佳实践之一，能大幅简化配置绑定的代码量。

具体实现步骤 #

1. 完善顶层配置类

确保ApplicationSettings的属性名称和配置文件（如appsettings.json）中的节名称对应（.NET配置系统默认支持大小写不敏感匹配，但保持一致更清晰）：

public class ApplicationSettings
{
    public DatabaseSettings Databases { get; set; }
    public NextSettings Nexts { get; set; }
    public AnotherSettings Anothers { get; set; }
    // 按需添加其他子配置类属性
}

// 保留你已有的子配置类，比如：
public class DatabaseSettings
{
    public const string DatabaseSettingsSectionKey = "Databases";
    public string SqlServerConnectionString { get; set; }
    public string AzureStorageConnectionString { get; set; }
}

public class NextSettings { /* 你的配置属性 */ }
public class AnotherSettings { /* 你的配置属性 */ }

2. 修改服务扩展方法，一次性绑定所有配置

只需要一次调用就能完成整个配置结构的绑定，同时保留启动时验证的能力：

public static IServiceCollection AddConfigurationOptions(this IServiceCollection services, IConfiguration configuration)
{
    // 绑定整个配置体系到ApplicationSettings，并注册为可注入的选项
    services.AddOptions<ApplicationSettings>()
        .Bind(configuration) // 直接传入根配置，系统会自动递归绑定嵌套属性
        .ValidateOnStart();

    // 可选：如果部分服务需要单独注入子配置类（比如IOptions<DatabaseSettings>），可以额外添加
    services.AddOptions<DatabaseSettings>()
        .Bind(configuration.GetSection(DatabaseSettings.DatabaseSettingsSectionKey))
        .ValidateOnStart();
    // 同理可以添加其他子配置类的单独注册...

    return services;
}

3. 配置文件结构对应

确保你的appsettings.json（或环境变量、密钥管理器等）的层级和类结构匹配，比如：

{
  "Databases": {
    "SqlServerConnectionString": "Server=...;Database=...",
    "AzureStorageConnectionString": "DefaultEndpointsProtocol=..."
  },
  "Nexts": {
    "YourNextSettingKey": "value"
  },
  "Anothers": {
    "YourAnotherSettingKey": "value"
  }
}

4. 使用配置

在需要使用配置的服务中，直接注入IOptions<ApplicationSettings>即可访问所有子配置：

public class YourService
{
    private readonly ApplicationSettings _settings;

    public YourService(IOptions<ApplicationSettings> settings)
    {
        _settings = settings.Value;
    }

    public void DoSomething()
    {
        var sqlConn = _settings.Databases.SqlServerConnectionString;
        var nextSetting = _settings.Nexts.YourNextSettingKey;
        // ...
    }
}

注意事项 #

• 配置系统会自动处理嵌套类的递归绑定，无需手动处理每个子节。
• 可以给配置类添加数据注解（如[Required]），或者在AddOptions后调用Validate方法实现自定义验证逻辑。
• 如果使用.NET 6+的最小API，绑定逻辑可以更简洁：

  var builder = WebApplication.CreateBuilder(args);
  var appSettings = builder.Configuration.Get<ApplicationSettings>();
  builder.Services.AddSingleton(appSettings);
  

内容的提问来源于stack exchange，提问作者Pure.Krome