【.Net8教程】(一)读取配置文件全面总结

环境：.net8.0

1. 准备条件

先在appsettings.Development.json或appsettings.json添加配置
添加一个DbOption

{
  "DbOption": {
    "Conn": "foolishsunday@csdn"
  }
}

2.直接读取json配置节点的几种写法

在Main函数中读取json配置
方式一

var conn1 = builder.Configuration["DbOption:Conn"];

方式二

var conn2 = builder.Configuration.GetValue<string>("DbOption:Conn");

方式三

var conn3 = builder.Configuration.GetSection("DbOption").GetSection("Conn").Value;

方式四

var conn4 = builder.Configuration.GetSection("DbOption")["Conn"];

3.转化为类或record类型

定义类

    public class DbOption
    {
        public string Conn { get; set; }
    }

转化

DbOption opt = builder.Configuration.GetSection(nameof(DbOption)).Get<DbOption>();

4.通过注入IConfiguration方式

    [ApiController]
    [Route("[controller]")]
    public class TestController : ControllerBase
    {
        private readonly IConfiguration _configuration;

        public TestController(IConfiguration configuration)
        {
            _configuration = configuration;
        }
        [HttpPost]
        public async Task<IActionResult> GetConfig()
        {
            var conn1 = _configuration["DbOption:Conn"];
            var conn2 = _configuration.GetValue<string>("DbOption:Conn");
            var conn3 = _configuration.GetSection(nameof(DbOption)).GetSection("Conn").Value;
            return Ok();
        }   
    }

5.或通过Options模式（推荐）

写法一

builder.Services.Configure<DbOption>(builder.Configuration.GetSection(nameof(DbOption)));

写法二

builder.Services.AddOptions<DbOption>().Bind(builder.Configuration.GetSection(nameof(DbOption)));

写法三

builder.Services.AddOptions<DbOption>().BindConfiguration(nameof(DbOption));

然后通过注入IOptions、IOptionsMonitor或IOptionsSnapshot获取

    [ApiController]
    [Route("[controller]")]
    public class DemoController : ControllerBase
    {
        private readonly DbOption _dbOption;

        public DemoController(IOptionsSnapshot<DbOption> options)
        {
            _dbOption = options.Value;//注意此处为.Value
        }   
    }

推荐使用IOptionsSnapshot

Options模式有三个接口IOptions、IOptionsMonitor或IOptionsSnapshot
IOption ：单例，一旦生成就不会再更改，除非通过代码的方式更改；
OptionsMonitor ：也是单例，但是它只要配置有变更，它就会更新，能通过代码的方式更改值；
IOptionsSnapshot ：作用域注册，一次请求里值不会变，在配置文件更新的下一次请求，它的值会更新，但是它不能跨范围通过代码的方式更改值，只能在当前范围（请求）内有效

校验

Options模式中，如果忘记了配置，获取到值为null，是不会报错的。
如果需要在获取到null时报错，则可以在Bind或BindConfiguration后添加Validate校验（可抛OptionsValidationException异常）

builder.Services.AddOptions<DbOption>().BindConfiguration(nameof(DbOption))
.Validate(option =>
{
    if (string.IsNullOrEmpty(option.Conn)) return false;
    else return true;
});

如此，在controller或service里，读取到Conn配置为空时，就会抛出异常。

6. 注意：调试和发布后启动，读取配置文件的区别

1、当启动vs调试时，由于启动的环境是Development，所以读取配置文件会优先读取appsettings.Development.json；如果没有值，才读取appsettings.json的值；
2、但当我们发布程序启动后（如双击.exe启动），则读取的是appsettings.json文件。
此区别可能会造成初学者产生混淆。