7.2配置系统与ASP.NET Core集成

7.2配置系统与ASP.NET Core集成

CreateBuilder方法会按照下面的顺序提供默认配置：

1. 加载现有的IConfiguration
2. 加载根目录下的appsettings.json
3. 加载根目录下的appesttings.Environment.json，Environment代表当前运行环境
4. 当程序运行在开发环境下，程序会加载“用户机密”配置
5. 加载环境变量
6. 加载命令行中的配置

这个顺序可以更改，但是不建议更改，在项目开发的时候，一般不需要再去编写配置系统的初始化代码，我们可以直接通过WebApplication的Configuration属性来读取配置。

ASP.NET Core多环境配置

常见的环境有开发环境、测试环境、生产环境，有时不同的环境需要进行不同的配置。

环境变量ASPNETCORE_ENVIRONMENT的值代表了程序运行环境的名字：Development(开发环境)、Staging(测试环境)、Production(生产环境)。如果没有设置ASPNETCORE_ENVIRONMENT则默认为生产环境。

可以通过app.Environment.EnvironmentName读取到运行环境的名字，而且可以通过app.IsDevelopment、app.IsStaging、app.IsProduction来判断环境。

if (app.Environment.IsDevelopment())//只有开发环境时，才支持Swagger
{
    app.UseSwagger();
    app.UseSwaggerUI();
}
1
2
3
4
5

ASP.Net Core会先从appsettings.json下加载配置，然后从appesttings.Environment.json加载配置，可以是appsettings.Development.json、appsettings.Staging.json、appsettings.Production.json。一般我们在appsettings.json下编写所有环境共有的配置，在appesttings.Environment.json中编写对应于环境的配置。

用户机密

某些信息不能放到源码配置文件中，比如连接字符串，里面含有连接账号及密码等信息。.net提供一个用户机密机制允许用户将机密信息放到一个单独的JSON文件中，且该文件不放在项目中，因此不会被错误的上传的Github中。

右键项目->管理用户机密->填写配置信息。这个文件会放在系统目录中某GUID编号目录下。使用用户机密的注意事项：

• 用户机密机制只是提供给开发者使用的
• 系统内的JSON文件被删除，则需要重新配置

配置在ASP.NET Core的使用

在WebApplication.CreateBuilder(args);下面添加配置语句

//在CreateBuilder方法中已经完成了配置系统的初始化，就不再需要使用service.AddOption方法来注册选项的相关服务
builder.Host.ConfigureAppConfiguration((_, configBuilder) => { //此处下划线是抛元，类似于占位符
    string connStr = builder.Configuration.GetConnectionString("configServer");//在用户机密里的节点
    configBuilder.AddDbConfiguration(() => new SqlConnection(connStr));
});
//需要写配置类和配置节点的绑定
builder.Services.Configure<SmtpOptions>(builder.Configuration.GetSection("Smtp"));//SmtpOptions是配置实体类
1
2
3
4
5
6
7