如何以类型安全的方式显式设置IConfiguration值？

我需要在测试环境中显式设置配置值，以适配测试时动态启动的资源。目前我可以通过以下两种方式实现，但希望采用更类型安全的方式，却找不到对应语法，请问我遗漏了什么？

builder.Configuration["ConnectionStrings:RecipeManagement"] = _dbContainer.ConnectionString;
// or
builder.Configuration.GetSection(ConnectionStringOptions.SectionName)["RecipeManagement"] = _dbContainer.ConnectionString;

以下是我的选项类，供参考：

namespace RecipeManagement.Configuration;

public class ConnectionStringOptions
{
    public const string SectionName = "ConnectionStrings";

    public string RecipeManagement { get; set; } = String.Empty;
}

public static class ConnectionStringOptionsExtensions
{
    public static ConnectionStringOptions GetConnectionStringOptions(this IConfiguration configuration)
        => configuration.GetSection(ConnectionStringOptions.SectionName).Get<ConnectionStringOptions>();
}

解决方案 #

你可以通过以下几种类型安全的方式实现配置值的设置，避免直接使用字符串键名带来的拼写错误：

方法1：绑定选项实例后反向更新配置 #

先获取当前的选项实例，修改属性后再绑定回配置节：

// 获取现有选项
var connectionOptions = builder.Configuration.GetConnectionStringOptions();
// 类型安全地修改属性
connectionOptions.RecipeManagement = _dbContainer.ConnectionString;
// 将修改后的实例绑定回配置
builder.Configuration.GetSection(ConnectionStringOptions.SectionName).Bind(connectionOptions);

方法2：添加类型安全的扩展方法 #

在现有的ConnectionStringOptionsExtensions类中添加一个Set扩展方法，封装配置更新逻辑：

public static class ConnectionStringOptionsExtensions
{
    public static ConnectionStringOptions GetConnectionStringOptions(this IConfiguration configuration)
        => configuration.GetSection(ConnectionStringOptions.SectionName).Get<ConnectionStringOptions>() ?? new ConnectionStringOptions();

    public static void SetConnectionStringOptions(this IConfiguration configuration, Action<ConnectionStringOptions> configure)
    {
        var options = configuration.GetConnectionStringOptions();
        configure(options);
        configuration.GetSection(ConnectionStringOptions.SectionName).Bind(options);
    }
}

使用时直接通过lambda表达式类型安全地设置属性：

builder.Configuration.SetConnectionStringOptions(options => 
{
    options.RecipeManagement = _dbContainer.ConnectionString;
});

方法3：使用ConfigurationBinder.Update（.NET 6+） #

如果你使用的是.NET 6及以上版本，可以直接用ConfigurationBinder.Update方法，将选项实例的属性值更新到配置节：

builder.Configuration.GetSection(ConnectionStringOptions.SectionName).Update(new ConnectionStringOptions
{
    RecipeManagement = _dbContainer.ConnectionString
});

或者基于现有选项修改后更新：

var existingOptions = builder.Configuration.GetConnectionStringOptions();
existingOptions.RecipeManagement = _dbContainer.ConnectionString;
builder.Configuration.GetSection(ConnectionStringOptions.SectionName).Update(existingOptions);

这些方法都直接操作ConnectionStringOptions类的属性，编译器会自动检查属性名称和类型，彻底避免字符串键名的拼写错误，实现真正的类型安全。

内容的提问来源于stack exchange，提问作者Paul DeVito