關于.NET Core選項模式【Options】的使用方法

發布時間：2020-07-01 16:17:09 來源：億速云閱讀：231 作者：清晨欄目：開發技術

這篇文章主要介紹關于.NET Core選項模式【Options】的使用方法，文中示例代碼介紹的非常詳細，具有一定的參考價值，感興趣的小伙伴們一定要看完！

ASP.NET Core引入了Options模式，使用類來表示相關的設置組。簡單的來說，就是用強類型的類來表達配置項，這帶來了很多好處。利用了系統的依賴注入，并且還可以利用配置系統。它使我們可以采用依賴注入的方法直接使用綁定的一個POCO對象，這個POCO對象就叫做Options對象。也可以叫做配置對象。

以下大多內容來自官方文檔，我只是個翻譯官或者叫搬運工吧！

引入Options擴展包

PM>Package-install Microsoft.Extensions.Options

綁定分層配置

在appsetting.json文件增加如下配置

"Position": {
  "Title": "Editor",
  "Name": "Joe Smith"
 }

創建以下 PositionOptions 類：

public class PositionOptions
{
  public const string Position = "Position";

  public string Title { get; set; }
  public string Name { get; set; }
}

選項類：

必須是包含公共無參數構造函數的非抽象類。
類型的所有公共讀寫屬性都已綁定。
不會綁定字段。在上面的代碼中，Position 未綁定。由于使用了 Position 屬性，因此在將類綁定到配置提供程序時，不需要在應用中對字符串 "Position" 進行硬編碼。

類綁定

調用 ConfigurationBinder.Bind 將 PositionOptions 類綁定到 Position 部分。然后就可以用了，當然這種方式在開發.NET Core種并不常用，一般采用依賴注入的方式注入。

var positionOptions = new PositionOptions();
Configuration.GetSection(PositionOptions.Position).Bind(positionOptions);

使用 ConfigurationBinder.Get 可能比使用 ConfigurationBinder.Bind 更方便。

positionOptions = Configuration.GetSection(PositionOptions.Position).Get<PositionOptions>();

依賴項注入服務容器

修改ConfigureServices方法

public void ConfigureServices(IServiceCollection services)
{
  services.Configure<PositionOptions>(Configuration.GetSection(
                    PositionOptions.Position));
  services.AddRazorPages();
}

通過使用前面的代碼，以下代碼將讀取位置選項：

public class Test2Model : PageModel
{
  private readonly PositionOptions _options;

  public Test2Model(IOptions<PositionOptions> options)
  {
    _options = options.Value;
  }

  public ContentResult OnGet()
  {
    return Content($"Title: {_options.Title} \n" +
            $"Name: {_options.Name}");
  }
}

選項接口
初學者會發現這個框架有3個主要的面向消費者的接口：IOptions、IOptionsMonitor以及IOptionsSnapshot。

這三個接口初看起來很類似，所以很容易引起困惑，什么場景下該用哪個接口呢？

1.IOptions

不支持

（1）在應用啟動后讀取配置數據。

（2）命名選項

注冊為單一實例，可以注入到任何服務生存期。

2.IOptionsSnapshot

作用域容器配置熱更新使用它
注冊為范圍內，因此無法注入到單一實例服務
支持命名選項

3.IOptionsMonitor

用于檢索選項并管理 TOptions 實例的選項通知。
注冊為單一實例且可以注入到任何服務生存期。
支持

（1）更改通知
（2）命名選項
（3）可重載配置
（4）選擇性選項失效

使用 IOptionsSnapshot 讀取已更新的數據

IOptionsMonitor 和 IOptionsSnapshot 之間的區別在于：

IOptionsMonitor 是一種單一示例服務，可隨時檢索當前選項值，這在單一實例依賴項中尤其有用。
IOptionsSnapshot 是一種作用域服務，并在構造 IOptionsSnapshot 對象時提供選項的快照。選項快照旨在用于暫時性和有作用域的依賴項。

public class TestSnapModel : PageModel
{
  private readonly MyOptions _snapshotOptions;

  public TestSnapModel(IOptionsSnapshot<MyOptions> snapshotOptionsAccessor)
  {
    _snapshotOptions = snapshotOptionsAccessor.Value;
  }

  public ContentResult OnGet()
  {
    return Content($"Option1: {_snapshotOptions.Option1} \n" +
            $"Option2: {_snapshotOptions.Option2}");
  }
}

IOptionsMonitor

public class TestMonitorModel : PageModel
{
  private readonly IOptionsMonitor<MyOptions> _optionsDelegate;

  public TestMonitorModel(IOptionsMonitor<MyOptions> optionsDelegate )
  {
    _optionsDelegate = optionsDelegate;
  }

  public ContentResult OnGet()
  {
    return Content($"Option1: {_optionsDelegate.CurrentValue.Option1} \n" +
            $"Option2: {_optionsDelegate.CurrentValue.Option2}");
  }
}

命名選項支持使用 IConfigureNamedOptions

命名選項：

當多個配置節綁定到同一屬性時有用。
區分大小寫。

appsettings.json文件

{
 "TopItem": {
  "Month": {
   "Name": "Green Widget",
   "Model": "GW46"
  },
  "Year": {
   "Name": "Orange Gadget",
   "Model": "OG35"
  }
 }
}

下面的類用于每個節，而不是創建兩個類來綁定 TopItem:Month 和 TopItem:Year

public class TopItemSettings
{
  public const string Month = "Month";
  public const string Year = "Year";

  public string Name { get; set; }
  public string Model { get; set; }
}

依賴注入容器

public void ConfigureServices(IServiceCollection services)
{
  services.Configure<TopItemSettings>(TopItemSettings.Month,
                    Configuration.GetSection("TopItem:Month"));
  services.Configure<TopItemSettings>(TopItemSettings.Year,
                    Configuration.GetSection("TopItem:Year"));

  services.AddRazorPages();
}

服務應用

public class TestNOModel : PageModel
{
  private readonly TopItemSettings _monthTopItem;
  private readonly TopItemSettings _yearTopItem;

  public TestNOModel(IOptionsSnapshot<TopItemSettings> namedOptionsAccessor)
  {
    _monthTopItem = namedOptionsAccessor.Get(TopItemSettings.Month);
    _yearTopItem = namedOptionsAccessor.Get(TopItemSettings.Year);
  }
}

使用 DI 服務配置選項

在配置選項時，可以通過以下兩種方式通過依賴關系注入訪問服務：

將配置委托傳遞給 OptionsBuilder 上的 Configure

services.AddOptions<MyOptions>("optionalName")
  .Configure<Service1, Service2, Service3, Service4, Service5>(
    (o, s, s2, s3, s4, s5) => 
      o.Property = DoSomethingWith(s, s2, s3, s4, s5));

創建實現 IConfigureOptions 或 IConfigureNamedOptions 的類型，并將該類型注冊為服務

建議將配置委托傳遞給 Configure，因為創建服務較復雜。在調用 Configure 時，創建類型等效于框架執行的操作。調用 Configure 會注冊臨時泛型 IConfigureNamedOptions，它具有接受指定的泛型服務類型的構造函數。

選項驗證

appsettings.json 文件

{
 "MyConfig": {
  "Key1": "My Key One",
  "Key2": 10,
  "Key3": 32
 }
}

下面的類綁定到 "MyConfig" 配置節，并應用若干 DataAnnotations 規則：

public class MyConfigOptions
{
  public const string MyConfig = "MyConfig";

  [RegularExpression(@"^[a-zA-Z''-'\s]{1,40}$")]
  public string Key1 { get; set; }
  [Range(0, 1000,
    ErrorMessage = "Value for {0} must be between {1} and {2}.")]
  public int Key2 { get; set; }
  public int Key3 { get; set; }
}

啟用DataAnnotations驗證

public void ConfigureServices(IServiceCollection services)
{
  services.AddOptions<MyConfigOptions>()
    .Bind(Configuration.GetSection(MyConfigOptions.MyConfig))
    .ValidateDataAnnotations();

  services.AddControllersWithViews();
}

使用IValidateOptions更復雜的配置

public class MyConfigValidation : IValidateOptions<MyConfigOptions>
{
  public MyConfigOptions _config { get; private set; }

  public MyConfigValidation(IConfiguration config)
  {
    _config = config.GetSection(MyConfigOptions.MyConfig)
      .Get<MyConfigOptions>();
  }

  public ValidateOptionsResult Validate(string name, MyConfigOptions options)
  {
    string vor=null;
    var rx = new Regex(@"^[a-zA-Z''-'\s]{1,40}$");
    var match = rx.Match(options.Key1);

    if (string.IsNullOrEmpty(match.Value))
    {
      vor = $"{options.Key1} doesn't match RegEx \n";
    }

    if ( options.Key2 < 0 || options.Key2 > 1000)
    {
      vor = $"{options.Key2} doesn't match Range 0 - 1000 \n";
    }

    if (_config.Key2 != default)
    {
      if(_config.Key3 <= _config.Key2)
      {
        vor += "Key3 must be > than Key2.";
      }
    }

    if (vor != null)
    {
      return ValidateOptionsResult.Fail(vor);
    }

    return ValidateOptionsResult.Success;
  }
}

IValidateOptions 允許將驗證代碼移出 StartUp 并將其移入類中。

使用前面的代碼，使用以下代碼在 Startup.ConfigureServices 中啟用驗證

public void ConfigureServices(IServiceCollection services)
{
  services.Configure<MyConfigOptions>(Configuration.GetSection(
                    MyConfigOptions.MyConfig));
  services.TryAddEnumerable(ServiceDescriptor.Singleton<IValidateOptions
               <MyConfigOptions>, MyConfigValidation>());
  services.AddControllersWithViews();
}

選項后期配置

使用 IPostConfigureOptions 設置后期配置。進行所有 IConfigureOptions 配置后運行后期配置

services.PostConfigure<MyOptions>(myOptions =>
{
  myOptions.Option1 = "post_configured_option1_value";
});

使用 PostConfigureAll 對所有配置實例進行后期配置

在啟動期間訪問選項

IOptions 和 IOptionsMonitor 可用于 Startup.Configure 中，因為在 Configure 方法執行之前已生成服務。

public void Configure(IApplicationBuilder app, 
  IOptionsMonitor<MyOptions> optionsAccessor)
{
  var option1 = optionsAccessor.CurrentValue.Option1;
}

結論

IOptions<>是單例，因此一旦生成了，除非通過代碼的方式更改，它的值是不會更新的。

IOptionsMonitor<>也是單例，但是它通過IOptionsChangeTokenSource<> 能夠和配置文件一起更新，也能通過代碼的方式更改值。

IOptionsSnapshot<>是范圍，所以在配置文件更新的下一次訪問，它的值會更新，但是它不能跨范圍通過代碼的方式更改值，只能在當前范圍（請求）內有效。

所以你應該根據你的實際使用場景來選擇到底是用這三者中的哪一個。

一般來說，如果你依賴配置文件，那么首先考慮IOptionsMonitor<>，如果不合適接著考慮IOptionsSnapshot<>，最后考慮IOptions<>。

有一點需要注意，在ASP.NET Core應用中IOptionsMonitor可能會導致同一個請求中選項的值不一致,當你正在修改配置文件的時候,這可能會引發一些奇怪的bug。

如果這個對你很重要，請使用IOptionsSnapshot，它可以保證同一個請求中的一致性，但是它可能會帶來輕微的性能上的損失。
如果你是在app啟動的時候自己構造Options（比如在Startup類中）：

services.Configure<TestOptions>(opt => opt.Name = "Test");

IOptions<>最簡單，也許是一個不錯的選擇。

以上是關于.NET Core選項模式【Options】的使用方法的所有內容，感謝各位的閱讀！希望分享的內容對大家有幫助，更多相關知識，歡迎關注億速云行業資訊頻道！

向AI問一下細節

中文字幕av专区_日韩电影在线播放_精品国产精品久久一区免费式_av在线免费观看网站

關于.NET Core選項模式【Options】的使用方法

猜你喜歡

中文字幕av专区_日韩电影在线播放_精品国产精品久久一区免费式_av在线免费观看网站

關于.NET Core選項模式【Options】的使用方法

猜你喜歡

最新資訊

相關推薦

相關標簽