.Net Core 配置文件讀取 – IOptions、IOptionsMonitor、IOptionsSnapshot

原文鏈接：//www.cnblogs.com/ysmc/p/16637781.html

　　眾所周知，appsetting.json 配置文件是.Net 的重大革新之心，拋開了以前繁雜的xml文件，使用了更簡潔易懂的json方式，簡直不要太舒服了！東西雖然好，但怎麼在程式中讀取這個配置呢，是每個新手必須要跨過去的坑（當然也是包括我這個菜狗子）。

　　遇事不明上注入，只要是遇到不知道怎麼辦的事，首先要往注入方便想，框架有了這個配置文件，必然配備了簡單直接的讀取API，按照我的習慣，直接上程式碼：

首先，我們在配置文件中，增加 Demo 配置節點：

{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft.AspNetCore": "Warning"
    }
  },
  "Demo": {
    "Value1": "1",
    "Value2": "2",
    "Value3": "3",
    "Value4": "4"
  }
}

在需要用到配置文件的地方，注入 IConfiguration 服務介面

private readonly IConfiguration _configuration;

public ValuesController(IConfiguration configuration)
{
    _configuration = configuration;
}

通常，我們比較直接的方式是通過 GetSection 獲取對應的配置節點，然後再獲取對應的配置項

var section = _configuration.GetSection("Demo");
var value1 = section.GetValue("Value1", "1");

如果 Demo 節點內還有更深的節點，GetSection 可以通過 : 深入到對應的下一個節點

appsetting.json 

{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft.AspNetCore": "Warning"
    }
  },
  "Demo": {
    "Value1": "1",
    "Value2": "2",
    "Value3": "3",
    "Value4": "4",
    "Model" {
      "Name": "小二",
      "Phone": "12345678911"
    }
  }
}
var model = _configuration.GetSection("Demo:Model");

有些小夥伴可能就會問了，那我每個需要用到的地方都需要直接以字元串作為參數去讀取配置，以後要是突然改了配置項，豈不是非常麻煩；

這點小夥伴們大可放心，你可以定義一個實體類，然後綁定上去，以後有什麼更改了，直接重命名對應的屬性就行了，實例程式碼

方法一：

var options = new DemoOptions();
_configuration.GetSection("Demo").Bind(options);

方法二：

var options2 = _configuration.GetSection("Demo").Get<DemoOptions>();

方法三：在 Startup.cs、.Net 6 以上在 Program.cs- 中使用依賴注入方式，以下是 .Net 6 

builder.Services.Configure<DemoOptions>(builder.Configuration.GetSection("Demo"));

在需要使用的地方注入  IOptions<TOptions> 即可獲取到配置值，需要注意的是，IOptions 是單例（Singleton）服務，即在應用啟動時進行註冊，後續更改配置文件，該 IOptions 將不會同步更新，依然還是舊值 

private readonly DemoOptions _demoOptions;

public ValuesController(IOptions<DemoOptions> options)
{
    _demoOptions = options.Value;
}

如需要配置進行熱更新，只需要改成注入 IOptionsMonitor<TOptions> 或者 IOptionsSnapshot<TOptions>；IOptionsSnapshot<TOptions>的生命周期是作用域（Scoped），每次請求都會重新獲取一次配置；IOptionsSnapshot<TOptions> 的生命周期是單例（Singleton），與 IOptions<TOptions> 不一樣的是當配置文件發生改變時，將會自動同步響應。

 

Tags:

VirMach 便宜 VPS

QNews

QNews