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

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 就会读取新值。

实际使用示例

定义选项类:

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 并理解其作用域生命周期。

以上就是ASP.NET Core 中的选项快照如何获取配置变更?的详细内容,更多请关注创想鸟其它相关文章!

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 chuangxiangniao@163.com 举报,一经查实,本站将立刻删除。
发布者:程序猿,转转请注明出处:https://www.chuangxiangniao.com/p/1440799.html

(0)
打赏 微信扫一扫 微信扫一扫 支付宝扫一扫 支付宝扫一扫
上一篇 2025年12月17日 17:27:01
下一篇 2025年12月17日 17:27:16

相关推荐

发表回复

登录后才能评论
关注微信