ASP.NET Core怎么读取配置文件 IConfiguration使用方法
发布时间 - 2025-12-29 00:00:00 点击率:次ASP.NET Core 通过 IConfiguration 统一读取多源配置,依赖注入 + 强类型绑定是推荐方式;默认加载 appsettings.json、环境变量等,Program.cs 中 WebApplicationBuilder.Configuration 开箱即用,服务中应注入 IConfiguration 或 IOptions 而非手动解析。
ASP.NET Core 通过 IConfiguration 接口统一读取各种来源的配置(如 appsettings.json、环境变量、命令行参数等),核心是依赖注入 + 配置绑定,不是手动解析文件。
配置自动注入到 Startup 或 Program 中
在 .NET 6+ 的最小托管模型(Program.cs)中,WebApplicationBuilder.Configuration 就是已预配置好的 IConfiguration 实例,开箱即用:
- 它默认加载
appsettings.json、appsettings.{Environment}.json、环境变量、命令行参数等 - 无需手动创建或调用
ConfigurationBuilder,除非你有特殊需求(比如额外加自定义源)
在服务中使用 IConfiguration(推荐方式)
把 IConfiguration 作为构造函数参数注入,避免静态访问或全局实例:
public class MyService
{
private readonly IConfiguration _config;
public MyService(IConfiguration config)
{
_config = config;
}
public void DoWork()
{
string connStr = _config.GetConnectionString("DefaultConnection");
string apiHost = _config["ApiSettings:Host"]; // 冒号表示层级(对应 JSON 中的嵌套对象)
int timeout = _config.GetValue("ApiSettings:Timeout", 30); // 带默认值
}
}
注意:_config["Section:Key"] 是最轻量的读取方式,
适合简单场景;但更推荐类型安全的绑定。
用强类型对象绑定配置(更安全、可测试)
先定义 POCO 类(属性名需与配置键匹配):
public class ApiSettings
{
public string Host { get; set; } = string.Empty;
public int Timeout { get; set; } = 30;
public bool EnableLogging { get; set; }
}
在 Program.cs 中注册绑定:
builder.Services.Configure(builder.Configuration.GetSection("ApiSettings"));
然后在服务中注入 IOptions:
public class MyService
{
private readonly ApiSettings _apiSettings;
public MyService(IOptions options)
{
_apiSettings = options.Value; // 或 IOptionsSnapshot 获取当前快照
}
}
这样支持验证、重载(配合 IOptionsMonitor)、单元测试,也避免硬编码字符串键。
常见配置源和优先级
默认顺序(后加载的覆盖前面同名项):
- appsettings.json
- appsettings.{Environment}.json(如 Development / Production)
- 用户密钥(仅 Development,
dotnet user-secrets) - 环境变量(如
ApiSettings__Host=api.example.com,双下划线代替冒号) - 命令行参数(
--ApiSettings:Host api.example.com)
所有来源最终都合并进同一个 IConfiguration 树,读取方式完全一致。
基本上就这些。不复杂但容易忽略的是:别直接 new ConfigurationBuilder,别用 static ConfigurationManager,坚持依赖注入 + 强类型绑定,配置就既清晰又可靠。
# js
# json
# 编码
# app
# 环境变量
# 配置文件
# .net
# Static
# 构造函数
# 字符串
# 命令行参数
# 接口
# 对象
# 绑定
# 命令行
# 加载
# 即用
# 的是
# 下划线
# 你有
# 自定义
# 而非
# 又可
相关栏目:
【
网站优化151355 】
【
网络推广146373 】
【
网络技术251813 】
【
AI营销90571 】
相关推荐:
如何用JavaScript实现文本编辑器_光标和选区怎么处理
Laravel如何配置和使用队列处理异步任务_Laravel队列驱动与任务分发实例
Laravel的HTTP客户端怎么用_Laravel HTTP Client发起API请求教程
Laravel如何安装使用Debugbar工具栏_Laravel性能调试与SQL监控插件【步骤】
Laravel如何使用Blade组件和插槽?(Component代码示例)
如何在新浪SAE免费搭建个人博客?
如何在Windows服务器上快速搭建网站?
Android okhttputils现在进度显示实例代码
大型企业网站制作流程,做网站需要注册公司吗?
Python正则表达式进阶教程_复杂匹配与分组替换解析
Laravel如何操作JSON类型的数据库字段?(Eloquent示例)
Laravel怎么使用artisan命令缓存配置和视图
如何打造高效商业网站?建站目的决定转化率
如何在局域网内绑定自建网站域名?
Laravel如何处理文件下载请求?(Response示例)
🚀拖拽式CMS建站能否实现高效与个性化并存?
简单实现Android验证码
JavaScript如何实现音频处理_Web Audio API如何工作?
如何在云主机快速搭建网站站点?
无锡营销型网站制作公司,无锡网选车牌流程?
如何有效防御Web建站篡改攻击?
如何用西部建站助手快速创建专业网站?
手机软键盘弹出时影响布局的解决方法
如何获取免费开源的自助建站系统源码?
Android实现代码画虚线边框背景效果
专业型网站制作公司有哪些,我设计专业的,谁给推荐几个设计师兼职类的网站?
高防服务器租用如何选择配置与防御等级?
青岛网站建设如何选择本地服务器?
Laravel如何设置定时任务(Cron Job)_Laravel调度器与任务计划配置
香港服务器网站搭建教程-电商部署、配置优化与安全稳定指南
Laravel怎么实现API接口鉴权_Laravel Sanctum令牌生成与请求验证【教程】
,在苏州找工作,上哪个网站比较好?
制作网站软件推荐手机版,如何制作属于自己的手机网站app应用?
html5的keygen标签为什么废弃_替代方案说明【解答】
百度输入法全感官ai怎么关 百度输入法全感官皮肤关闭
网站制作怎么样才能赚钱,用自己的电脑做服务器架设网站有什么利弊,能赚钱吗?
米侠浏览器网页图片不显示怎么办 米侠图片加载修复
JS实现鼠标移上去显示图片或微信二维码
手机怎么制作网站教程步骤,手机怎么做自己的网页链接?
香港服务器部署网站为何提示未备案?
深圳网站制作公司好吗,在深圳找工作哪个网站最好啊?
php静态变量怎么调试_php静态变量作用域调试技巧【解答】
如何用狗爹虚拟主机快速搭建网站?
北京的网站制作公司有哪些,哪个视频网站最好?
,交易猫的商品怎么发布到网站上去?
iOS正则表达式验证手机号、邮箱、身份证号等
Laravel如何自定义错误页面(404, 500)?(代码示例)
canvas 画布在主流浏览器中的尺寸限制详细介绍
Android使用GridView实现日历的简单功能
Laravel Telescope怎么调试_使用Laravel Telescope进行应用监控与调试

