0

0

ASP.NET Core 中的选项快照如何获取配置变更?

月夜之吻

月夜之吻

发布时间:2025-10-20 10:39:01

|

150人浏览过

|

来源于php中文网

原创

IOptionsSnapshot在每次请求时读取最新配置,通过Scoped生命周期和reloadOnChange: true实现配置热更新。

asp.net core 中的选项快照如何获取配置变更?

ASP.NET Core 中的选项快照(IOptionsSnapshot)能够在每次请求开始时获取最新的配置,从而反映配置文件的变更。它通过依赖注入在每个请求作用域内重新计算选项值,实现对配置变化的响应。

工作原理:基于请求作用域

IOptionsSnapshot 的核心机制是“每次请求创建一个新的实例”。它在请求开始时读取当前的配置源(如 appsettings.json),因此如果配置文件在此前已重新加载,新请求就能看到更新后的值。

关键点:

  • 生命周期为 Scoped,即每个请求使用一个独立的选项实例。
  • 依赖 IConfiguration 的变更检测机制(如文件监听)。
  • 只有在配置源触发重载后,IOptionsSnapshot 才能获取到新值。

确保配置文件变更被监听

默认情况下,ASP.NET Core 使用 FileConfigurationSource 监听 appsettings.json 文件变化,并自动重载配置。需确认以下设置:

builder.Configuration.AddJsonFile("appsettings.json", optional: false, reloadOnChange: true);

其中 reloadOnChange: true 是关键,它启用文件系统监听。当文件保存时,IConfiguration 自动刷新,后续请求中 IOptionsSnapshot 就会读取新值。

实际使用示例

定义选项类:

宣小二
宣小二

宣小二:媒体发稿平台,自媒体发稿平台,短视频矩阵发布平台,基于AI驱动的企业自助式投放平台。

下载
public class MyOptions
{
public string Value { get; set; } = string.Empty;
}

注册服务:

builder.Services.Configure(builder.Configuration.GetSection("MyOptions"));

在控制器中使用:

public class HomeController : Controller
{
private readonly IOptionsSnapshot _options;

public HomeController(IOptionsSnapshot options)
{
_options = options;
}

public IActionResult Index()
{
var value = _options.Value.Value;
return Content(value);
}
}

每次访问 Index 方法时,都会读取当前最新的配置值。

与 IOptions 和 IOptionsMonitor 的区别

  • IOptions:Singleton,启动时读取一次,不响应变更。
  • IOptionsSnapshot:Scoped,每次请求读取一次,适合请求级配置变更。
  • IOptionsMonitor:Singleton,支持实时变更通知(通过 OnChange 回调),适合高频变更或后台服务。

基本上就这些。只要配置源启用了重载,IOptionsSnapshot 在下一次请求中自然就能拿到新值,无需额外代码干预。关键是确保 reloadOnChange: true 并理解其作用域生命周期。

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

413

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

533

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

310

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

75

2025.09.10

string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

318

2023.08.02

class在c语言中的意思
class在c语言中的意思

在C语言中,"class" 是一个关键字,用于定义一个类。想了解更多class的相关内容,可以阅读本专题下面的文章。

465

2024.01.03

python中class的含义
python中class的含义

本专题整合了python中class的相关内容,阅读专题下面的文章了解更多详细内容。

13

2025.12.06

Java JVM 原理与性能调优实战
Java JVM 原理与性能调优实战

本专题系统讲解 Java 虚拟机(JVM)的核心工作原理与性能调优方法,包括 JVM 内存结构、对象创建与回收流程、垃圾回收器(Serial、CMS、G1、ZGC)对比分析、常见内存泄漏与性能瓶颈排查,以及 JVM 参数调优与监控工具(jstat、jmap、jvisualvm)的实战使用。通过真实案例,帮助学习者掌握 Java 应用在生产环境中的性能分析与优化能力。

4

2026.01.20

PS使用蒙版相关教程
PS使用蒙版相关教程

本专题整合了ps使用蒙版相关教程,阅读专题下面的文章了解更多详细内容。

55

2026.01.19

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WEB前端教程【HTML5+CSS3+JS】
WEB前端教程【HTML5+CSS3+JS】

共101课时 | 8.4万人学习

JS进阶与BootStrap学习
JS进阶与BootStrap学习

共39课时 | 3.2万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号