当前位置： 首页 > news >正文

.NET 的配置系统

news 2025/7/22 2:56:57

一.引言：为什么需要配置系统？

在软件开发中，读取配置而不是硬编码的设计被广泛使用 —— 数据库连接、API 密钥、缓存策略、第三方服务地址……
.NET 提供了一套统一、可扩展的配置系统，广泛适用于：

  • 控制台程序

  • ASP.NET Core Web API / MVC

  • 后台服务 / Worker

  • Blazor / MAUI / 云函数

本文基于.net8简单介绍一下.net配置系统的使用

文章的前面会使用控制台主动引入配置相关的包,然后介绍这些包的基本用法,根本目的是为了在Asp.Net WebApi中通过依赖注入的形式使用.

二.Donet强大的配置系统

<ItemGroup><PackageReference Include="Microsoft.Extensions.Configuration" Version="9.0.6" /><PackageReference Include="Microsoft.Extensions.Configuration.Json" Version="9.0.6" />
</ItemGroup>

创建控制台并引入上面两个包,前者是基础包,后者是基于前者的有关Json配置方面的拓展包.

显然不止有Json拓展包,donet广泛支持各种配资源:包括文件(json,xml,ini,yaml等),注册表,环境变量,命令行等等,还可以配置自定义配置源,只需要引入相应的包就可以了.

还可以跟踪配置的改变,可以按照优先级覆盖等等满足现代化开发的需求.

本文主要介绍使用Json作为配置源的选项.

三.控制台使用

{"AppName": "TestConsoleApp","ApiSettings": {"BaseUrl": "https://api.example.com","Timeout": 30}
}

 

根目录创建一个json文件(别忘了右键属性将其设为如果较新则复制)

     static void Main(string[] args){//先实例一个配置构建对象ConfigurationBuilder configurationBuilder = new ConfigurationBuilder();//配置json文件路径(根目录下,当然也可以放在某个目录下) optional(为真的话如果文件路径错误抛异常)//reloadOnChange为真则检测配置是否改变,改变重新加载configurationBuilder.AddJsonFile("config.json", optional: false, reloadOnChange: true);IConfigurationRoot configurationRoot = configurationBuilder.Build();//键的名称大小写不敏感string? appName = configurationRoot["appName"];           //可以使用冒号向下一个节点查询var baseUrl = configurationRoot["ApiSettings:baseUrl"];var timeout = configurationRoot.GetSection("ApiSettings:Timeout").Value;Console.WriteLine($"appName:{appName}");            Console.WriteLine($"baseUrl:{baseUrl}");Console.WriteLine($"timeout:{timeout}");           Console.ReadKey();}

你或许注意到

var baseUrl = configurationRoot["ApiSettings:baseUrl"];

var timeout = configurationRoot.GetSection("ApiSettings:Timeout").Value;

这两种方案完成了一样的事,两者什么区别?

维度索引器方式 ["A:B"]GetSection("A:B").Value
📌 简洁性✅ 更短，适合快速取值稍长，写法冗长一些
🔍 获取子对象❌ 无法获取嵌套对象（只支持值）✅ 可获取子节并递归操作
📦 支持绑定❌ 不可绑定成类对象✅ 可用 .Bind() 或 .Get<T>()
🧪 空值处理✅ 直接为 null✅ .Value 也是 null，但可以先判断 Exists()
 internal class Program{static void Main(string[] args){//先实例一个配置构建对象ConfigurationBuilder configurationBuilder = new ConfigurationBuilder();//配置json文件路径(根目录下,当然也可以放在某个目录下) optional(为真的话如果文件路径错误抛异常)//reloadOnChange为真则检测配置是否改变,改变重新加载configurationBuilder.AddJsonFile("config.json", optional: false, reloadOnChange: true);IConfigurationRoot configurationRoot = configurationBuilder.Build();//键的名称大小写不敏感string? appName = configurationRoot["appName"];var apiSetting = configurationRoot.GetSection("ApiSettings").Get<ApiSettings>();Console.WriteLine(apiSetting.BaseUrl);Console.WriteLine(apiSetting.Timeout);}}public class ApiSettings{public string BaseUrl { get; set; }public int Timeout { get; set; }}

简单的说就是前者用起来很快捷,但是只能获取子节点的某个值.

而后者话,你可以声明一个实体来承载整个子节点(支持嵌套),利用Get<T>方法.

使用Get<T>方法需要引入Microsoft.Extensions.Configuration.Binder.

 internal class Program{static void Main(string[] args){//先实例一个配置构建对象ConfigurationBuilder configurationBuilder = new ConfigurationBuilder();//配置json文件路径(根目录下,当然也可以放在某个目录下) optional(为真的话如果文件路径错误抛异常)//reloadOnChange为真则检测配置是否改变,改变重新加载configurationBuilder.AddJsonFile("config.json", optional: false, reloadOnChange: true);IConfigurationRoot configurationRoot = configurationBuilder.Build();var appConfig = configurationRoot.Get<AppConfig>();Console.WriteLine(appConfig.AppName);Console.WriteLine(appConfig.ApiSettings.BaseUrl);Console.WriteLine(appConfig.ApiSettings.Timeout);}}public class ApiSettings{public string BaseUrl { get; set; }public int Timeout { get; set; }}public class AppConfig{public string AppName { get; set; }public ApiSettings ApiSettings { get; set; }}

既然能获取子节点的对象,那显然也能直接获取根节点对象.

    static void Main(string[] args){//先实例一个配置构建对象ConfigurationBuilder configurationBuilder = new ConfigurationBuilder();//配置json文件路径(根目录下,当然也可以放在某个目录下) optional(为真的话如果文件路径错误抛异常)//reloadOnChange为真则检测配置是否改变,改变重新加载configurationBuilder.AddJsonFile("config.json", optional: false, reloadOnChange: true);IConfigurationRoot configurationRoot = configurationBuilder.Build();AppConfig appConfig=new AppConfig();configurationRoot.Bind(appConfig);Console.WriteLine(appConfig.AppName);Console.WriteLine(appConfig.ApiSettings.BaseUrl);Console.WriteLine(appConfig.ApiSettings.Timeout);}
}public class ApiSettings
{public string BaseUrl { get; set; }public int Timeout { get; set; }
}public class AppConfig
{public string AppName { get; set; }public ApiSettings ApiSettings { get; set; }
}

不仅可以使用Get,还有一个重要方法是Bind,两者的区别是Get自动生成对象并将数据注入,而Bind需要你提供一个对象然后将数据注入.

Bind会在WebApi项目经常使用,Get一般是手动使用.

四.在WebApi项目通过依赖注入使用

使用WebApi模版创建的项目不需要手动引入上述提到的包,因为模版本身就已经帮我们准备好了.

在依赖项你也可以看到确实已经有这些包了,甚至相关的xml等包也都在.

 

 

 public static void Main(string[] args){var builder = WebApplication.CreateBuilder(args);// Add services to the container.builder.Services.AddControllers();// Learn more about configuring Swagger/OpenAPI at https://aka.ms/aspnetcore/swashbucklebuilder.Services.AddEndpointsApiExplorer();builder.Services.AddSwaggerGen();ConfigurationBuilder configurationBuilder = new ConfigurationBuilder();          configurationBuilder.AddJsonFile("config.json", optional: false, reloadOnChange: true);IConfigurationRoot configurationRoot = configurationBuilder.Build();builder.Services.AddOptions().Configure<AppConfig>(configurationRoot.Bind);

前三句还是老样子,只是最后一句将配置注册到服务里面

 [ApiController][Route("[controller]")]public class WeatherForecastController : ControllerBase{       private readonly ILogger<WeatherForecastController> _logger;private readonly IOptionsSnapshot<AppConfig> _optionsSnapshot;public WeatherForecastController(ILogger<WeatherForecastController> logger,IOptionsSnapshot<AppConfig> optionsSnapshot){_logger = logger;_optionsSnapshot = optionsSnapshot;}    [HttpGet][Route("GetConfig")]public ActionResult<AppConfig> GetConfig(){return Ok(_optionsSnapshot.Value);}}

然后就可以通过构造器注入配置.

实际上会同时注册以下三种服务的支持

类型生命周期说明
IOptions<AppConfig>Singleton每次请求拿到的是同一个配置对象
IOptionsSnapshot<AppConfig>Scoped（每次请求一份）适合 Web API 中 per-request 读取配置
IOptionsMonitor<AppConfig>Singleton支持配置变更监听（如热更新）

你有三种选择,需要那种注入那种就行了.

 ConfigurationBuilder configurationBuilder = new ConfigurationBuilder();          configurationBuilder.AddJsonFile("config.json", optional: false, reloadOnChange: true);IConfigurationRoot configurationRoot = configurationBuilder.Build();builder.Services.AddOptions().Configure<AppConfig>(configurationRoot.Bind).Configure<ApiSettings>(configurationRoot.GetSection("ApiSettings").Bind);

显然是可以配置多个的,比如刚才的AppConfig,如果你只关心它的某个子节点,也可以将子节点再注册成一个单独的配置.

前面我们手动构建了IConfigurationRoot configurationRoot 对象,但是在WebApi中我们不需要做这个工作,模版本身已经配置好了.

WebApi项目其实已经有了内置的顶级配置对象和对应的json配置文件

  public static void Main(string[] args){var builder = WebApplication.CreateBuilder(args);// Add services to the container.builder.Services.AddControllers();// Learn more about configuring Swagger/OpenAPI at https://aka.ms/aspnetcore/swashbucklebuilder.Services.AddEndpointsApiExplorer();builder.Services.AddSwaggerGen();//ConfigurationBuilder configurationBuilder = new ConfigurationBuilder();          //configurationBuilder.AddJsonFile("config.json", optional: false, reloadOnChange: true);//IConfigurationRoot configurationRoot = configurationBuilder.Build();//builder.Services.AddOptions().Configure<AppConfig>(configurationRoot.Bind)//    .Configure<ApiSettings>(configurationRoot.GetSection("ApiSettings").Bind);builder.Services.Configure<AppConfig>(builder.Configuration.GetSection("AppConfig").Bind);builder.Services.Configure<ApiSettings>(builder.Configuration.GetSection("AppConfig:ApiSettings").Bind);

这个builder.Configuration 就是系统为我们提供的配置对象

{"Logging": {"LogLevel": {"Default": "Information","Microsoft.AspNetCore": "Warning"}},"AllowedHosts": "*","AppConfig": {"AppName": "TestConsoleApp","ApiSettings": {"BaseUrl": "https://api.example.com","Timeout": 50}}
}

 所以我们的配置只需要写入appsetings.json就行了

http://www.lqws.cn/news/443053.html

相关文章：

  • 【Mini-F5265-OB开发板试用测评】2、PWM驱动遥控车RX2接收解码带马达驱动控制IC
  • 华为OD机试_2025 B卷_构成正方形数量（Python，100分）（附详细解题思路）
  • 如何获取Java对象的大小
  • MQTT 消息队列传输协议（Message Queuing Telemetry Transport)
  • 【深度学习】生成对抗网络（GANs）深度解析：从理论到实践的革命性生成模型
  • 优化 Python 爬虫性能：异步爬取新浪财经大数据
  • 46道Jenkins高频题整理(附答案背诵版)
  • Jenkins通过Pipeline流水线方式编译Java项目
  • IP 地理库的使用指南：从基础应用到深度实践​
  • Redis 持久化机制详解：RDB、AOF 原理与面试最佳实践（AOF篇）
  • IntersectionObserver API应用场景示例代码详解
  • 医疗低功耗智能AI网络搜索优化策略
  • jquery 赋值时不触发change事件解决——仙盟创梦IDE
  • Kafka性能压测报告撰写
  • Outlook邮箱开通发信服务及OAuth2验证开通
  • 靶场（二十五）---小白心得靶场体会---Access
  • 基于Python+PySide6构建的夸克网盘批量工具，支持批量转存与分享
  • 使用NPOI库导出多个Excel并压缩zip包
  • Qt 解析复杂对象构成
  • 基于C#的Baumer相机二次开发教程
  • VACM 详解：SNMPv3 的访问控制核心
  • 基于大模型的急性结石性胆囊炎全流程预测与诊疗方案研究
  • 小白畅通Linux之旅-----Rsync+sersync实现数据实时同步
  • 九九乘法表
  • [Data Pipeline] Kafka消息 | Redis缓存 | Docker部署(Lambda架构)
  • 编辑器及脚本案例
  • 2025-05-05-80x86汇编语言环境配置
  • Java中创建线程的几种方式
  • 软考-软件设计师--校验码
  • 矩阵置零C++