【.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}   }

校验

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文件。
此区别可能会造成初学者产生混淆。