ASP.NET Core 中的选项快照如何获取配置变更？-C#.Net教程-PHP中文网

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

月夜之吻

发布： 2025-10-20 10:39:01

原创

131人浏览过

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配音神器

208

查看详情

实际使用示例

定义选项类：

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 方法时，都会读取当前最新的配置值。