ASP.NET Core 2.2 基础知识(七)【选项】

最新推荐文章于 2026-05-10 15:35:43 发布
转载 最新推荐文章于 2026-05-10 15:35:43 发布 · 1.7k 阅读 · 2
本文探讨了ASP.NET Core中的选项模式，展示了如何使用不同类型的选项接口，如IOptionsMonitor和IOptionsSnapshot，来配置和验证应用设置。通过示例说明了如何实现简单选项、子选项、命名选项和后期配置，以及如何重新加载配置数据。

选项模式使用类来表示相关设置的组。 当配置设置由方案隔离到单独的类时，应用遵循两个重要软件工程原则：

  • 接口分离原则 (ISP) 或封装– 依赖于配置设置的方案（类）仅依赖于其使用的配置设置。
  • 关注点分离– 应用的不同部件的设置不彼此依赖或相互耦合。

选项还提供验证配置数据的机制。 有关详细信息，请参阅选项验证部分。

系统必备

引用 Microsoft.AspNetCore.App 元包或将包引用添加到 Microsoft.Extensions.Options.ConfigurationExtensions 包。

选项接口

IOptionsMonitor<TOptions>用于检索选项并管理 TOptions 实例的选项通知。

IOptionsMonitor<TOptions> 支持以下方案：

  • 更改通知
  • 命名选项
  • 可重载配置
  • 选择性选项失效 (IOptionsMonitorCache<TOptions>)

后期配置方案允许你在进行所有 IConfigureOptions<TOptions> 配置后设置或更改选项。

IOptionsFactory<TOptions> 负责新建选项实例。 它具有单个 Create 方法。 默认实现采用所有已注册 IConfigureOptions<TOptions> 和 IPostConfigureOptions<TOptions> 并首先运行所有配置，然后才进行后期配置。 它区分 IConfigureNamedOptions<TOptions> 和 IConfigureOptions<TOptions> 且仅调用适当的接口。

IOptionsMonitorCache<TOptions> 由 IOptionsMonitor<TOptions> 用于缓存 TOptions 实例。 IOptionsMonitorCache<TOptions> 可使监视器中的选项实例无效，以便重新计算值 (TryRemove)。 可以通过 TryAdd 手动引入值。 在应按需重新创建所有命名实例时使用 Clear方法。

IOptionsSnapshot<TOptions> 在每次请求时应重新计算选项的方案中有用。 有关详细信息，请参阅通过 IOptionsSnapshot 重新加载配置数据部分。

IOptions<TOptions> 可用于支持选项。 但是，IOptions<TOptions> 不支持前面的 IOptionsMonitor<TOptions> 方案。 你可以在已使用 IOptions<TOptions> 接口的现有框架和库中继续使用 IOptions<TOptions>，并且不需要 IOptionsMonitor<TOptions> 提供的方案。

常规选项配置

常规选项配置已作为示例 #1 在示例应用中进行了演示。

选项类必须为包含公共无参数构造函数的非抽象类。 以下类 MyOptions 具有两种属性：Option1 和 Option2。 设置默认值为可选，但以下示例中的类构造函数设置了 Option1 的默认值。 Option2 具有通过直接初始化属性设置的默认值 (Models/MyOptions.cs)：

public class MyOptions
{
    public MyOptions()
    {
        // Set default value.
        Option1 = "value1_from_ctor";
    }
    
    public string Option1 { get; set; }
    public int Option2 { get; set; } = 5;
}

MyOptions 类已通过 Configure 添加到服务容器并绑定到配置：

// Example #1: General configuration
// Register the Configuration instance which MyOptions binds against.
services.Configure<MyOptions>(Configuration);

以下页面模型通过 IOptionsMonitor<TOptions> 使用构造函数依赖关系注入来访问设置 (Pages/Index.cshtml.cs)：

private readonly MyOptions _options;

public IndexModel(
    IOptionsMonitor<MyOptions> optionsAccessor, 
    IOptionsMonitor<MyOptionsWithDelegateConfig> optionsAccessorWithDelegateConfig, 
    IOptionsMonitor<MySubOptions> subOptionsAccessor, 
    IOptionsSnapshot<MyOptions> snapshotOptionsAccessor, 
    IOptionsSnapshot<MyOptions> namedOptionsAccessor)
{
    _options = optionsAccessor.CurrentValue;
    _optionsWithDelegateConfig = optionsAccessorWithDelegateConfig.CurrentValue;
    _subOptions = subOptionsAccessor.CurrentValue;
    _snapshotOptions = snapshotOptionsAccessor.Value;
    _named_options_1 = namedOptionsAccessor.Get("named_options_1");
    _named_options_2 = namedOptionsAccessor.Get("named_options_2");
}

// Example #1: Simple options
var option1 = _options.Option1;
var option2 = _options.Option2;
SimpleOptions = $"option1 = {option1}, option2 = {option2}";

示例的 appsettings.json 文件指定 option1 和 option2 的值：

{
  "option1": "value1_from_json",
  "option2": -1,
  "subsection": {
    "suboption1": "subvalue1_from_json",
    "suboption2": 200
  },
  "Logging": {
    "LogLevel": {
      "Default": "Warning"
    }
  },
  "AllowedHosts": "*"
}

运行应用时，页面模型的 OnGet 方法返回显示选项类值的字符串：

option1 = value1_from_json, option2 = -1

备注
使用自定义 ConfigurationBuilder 从设置文件加载选项配置时，请确认基路径设置正确：

var configBuilder = new ConfigurationBuilder()
   .SetBasePath(Directory.GetCurrentDirectory())
   .AddJsonFile("appsettings.json", optional: true);
var config = configBuilder.Build();

services.Configure<MyOptions>(config);

通过 xref:Microsoft.AspNetCore.WebHost.CreateDefaultBuilder* 从设置文件加载选项配置时，不需要显式设置基路径。

通过委托配置简单选项

通过委托配置简单选项已作为示例 #2 在示例应用中进行了演示。

使用委托设置选项值。 此示例应用使用 MyOptionsWithDelegateConfig 类 (Models/MyOptionsWithDelegateConfig.cs)：

public class MyOptionsWithDelegateConfig
{
    public MyOptionsWithDelegateConfig()
    {
        // Set default value.
        Option1 = "value1_from_ctor";
    }
    
    public string Option1 { get; set; }
    public int Option2 { get; set; } = 5;
}

在以下代码中，已向服务容器添加第二个 IConfigureOptions<TOptions> 服务。 它通过 MyOptionsWithDelegateConfig 使用委托来配置绑定：

// Example #2: Options bound and configured by a delegate
services.Configure<MyOptionsWithDelegateConfig>(myOptions =>
{
    myOptions.Option1 = "value1_configured_by_delegate";
    myOptions.Option2 = 500;
});

Index.cshtml.cs:

private readonly MyOptionsWithDelegateConfig _optionsWithDelegateConfig;

public IndexModel(
    IOptionsMonitor<MyOptions> optionsAccessor, 
    IOptionsMonitor<MyOptionsWithDelegateConfig> optionsAccessorWithDelegateConfig, 
    IOptionsMonitor<MySubOptions> subOptionsAccessor, 
    IOptionsSnapshot<MyOptions> snapshotOptionsAccessor, 
    IOptionsSnapshot<MyOptions> namedOptionsAccessor)
{
    _options = optionsAccessor.CurrentValue;
    _optionsWithDelegateConfig = optionsAccessorWithDelegateConfig.CurrentValue;
    _subOptions = subOptionsAccessor.CurrentValue;
    _snapshotOptions = snapshotOptionsAccessor.Value;
    _named_options_1 = namedOptionsAccessor.Get("named_options_1");
    _named_options_2 = namedOptionsAccessor.Get("named_options_2");
}

// Example #2: Options configured by delegate
var delegate_config_option1 = _optionsWithDelegateConfig.Option1;
var delegate_config_option2 = _optionsWithDelegateConfig.Option2;
SimpleOptionsWithDelegateConfig = 
    $"delegate_option1 = {delegate_config_option1}, " +
    $"delegate_option2 = {delegate_config_option2}";

可添加多个配置提供程序。 配置提供程序可从 NuGet 包中获取，并按照注册的顺序应用。 有关更多信息，请参见ASP.NET Core 中的配置。

每次调用 Configure 都会将 IConfigureOptions<TOptions> 服务添加到服务容器。 在前面的示例中，Option1 和 Option2 的值同时在 appsettings.json 中指定，但 Option1 和 Option2 的值被配置的委托替代。

当启用多个配置服务时，指定的最后一个配置源优于其他源，由其设置配置值。 运行应用时，页面模型的 OnGet 方法返回显示选项类值的字符串：

delegate_option1 = value1_configured_by_delgate, delegate_option2 = 500

子选项配置

子选项配置已作为示例 #3 在示例应用中进行了演示。

应用应创建适用于应用中特定方案组（类）的选项类。 需要配置值的部分应用应仅有权访问其使用的配置值。

将选项绑定到配置时，选项类型中的每个属性都将绑定到窗体 property[:sub-property:] 的配置键。 例如，MyOptions.Option1 属性将绑定到从 appsettings.json 中的 option1 属性读取的键 Option1。

在以下代码中，已向服务容器添加第三个 IConfigureOptions<TOptions> 服务。 它将 MySubOptions 绑定到 appsettings.json 文件的 subsection 部分：

// Example #3: Suboptions
// Bind options using a sub-section of the appsettings.json file.
services.Configure<MySubOptions>(Configuration.GetSection("subsection"));

GetSection 扩展方法需要 Microsoft.Extensions.Options.ConfigurationExtensions NuGet 包。 如果应用使用 Microsoft.AspNetCore.App metapackage 元包（ASP.NET Core 2.1 或更高版本），将自动包含此包。

示例的 appsettings.json 文件定义具有 suboption1 和 suboption2 的键的 subsection 成员：

{
  "option1": "value1_from_json",
  "option2": -1,
  "subsection": {
    "suboption1": "subvalue1_from_json",
    "suboption2": 200
  },
  "Logging": {
    "LogLevel": {
      "Default": "Warning"
    }
  },
  "AllowedHosts": "*"
}

MySubOptions 类将属性 SubOption1 和 SubOption2 定义为保留选项值 (Models/MySubOptions.cs)：

public class MySubOptions
{
    public MySubOptions()
    {
        // Set default values.
        SubOption1 = "value1_from_ctor";
        SubOption2 = 5;
    }
    
    public string SubOption1 { get; set; }
    public int SubOption2 { get; set; }
}

页面模型的 OnGet 方法返回包含选项值的字符串 (Pages/Index.cshtml.cs)：

private readonly MySubOptions _subOptions;

public IndexModel(
    IOptionsMonitor<MyOptions> optionsAccessor, 
    IOptionsMonitor<MyOptionsWithDelegateConfig> optionsAccessorWithDelegateConfig, 
    IOptionsMonitor<MySubOptions> subOptionsAccessor, 
    IOptionsSnapshot<MyOptions> snapshotOptionsAccessor, 
    IOptionsSnapshot<MyOptions> namedOptionsAccessor)
{
    _options = optionsAccessor.CurrentValue;
    _optionsWithDelegateConfig = optionsAccessorWithDelegateConfig.CurrentValue;
    _subOptions = subOptionsAccessor.CurrentValue;
    _snapshotOptions = snapshotOptionsAccessor.Value;
    _named_options_1 = namedOptionsAccessor.Get("named_options_1");
    _named_options_2 = namedOptionsAccessor.Get("named_options_2");
}

// Example #3: Suboptions
var subOption1 = _subOptions.SubOption1;
var subOption2 = _subOptions.SubOption2;
SubOptions = $"subOption1 = {subOption1}, subOption2 = {subOption2}";

运行应用时，OnGet 方法返回显示子选项类值的字符串：

subOption1 = subvalue1_from_json, subOption2 = 200

视图模型或通过直接视图注入提供的选项

视图模型或通过直接视图注入提供的选项已作为示例 #4 在示例应用中进行了演示。

可在视图模型中或通过将 IOptionsMonitor<TOptions> 直接注入到视图 (Pages/Index.cshtml.cs) 来提供选项：

private readonly MyOptions _options;

public IndexModel(
    IOptionsMonitor<MyOptions> optionsAccessor, 
    IOptionsMonitor<MyOptionsWithDelegateConfig> optionsAccessorWithDelegateConfig, 
    IOptionsMonitor<MySubOptions> subOptionsAccessor, 
    IOptionsSnapshot<MyOptions> snapshotOptionsAccessor, 
    IOptionsSnapshot<MyOptions> namedOptionsAccessor)
{
    _options = optionsAccessor.CurrentValue;
    _optionsWithDelegateConfig = optionsAccessorWithDelegateConfig.CurrentValue;
    _subOptions = subOptionsAccessor.CurrentValue;
    _snapshotOptions = snapshotOptionsAccessor.Value;
    _named_options_1 = namedOptionsAccessor.Get("named_options_1");
    _named_options_2 = namedOptionsAccessor.Get("named_options_2");
}

// Example #4: Bind options directly to the page
MyOptions = _options;

示例应用演示如何使用 @inject 指令注入 IOptionsMonitor<MyOptions>：

@page
@model IndexModel
@using Microsoft.Extensions.Options
@inject IOptionsMonitor<MyOptions> OptionsAccessor
@{
    ViewData["Title"] = "Options Sample";
}

<h1>@ViewData["Title"]</h1>

当应用运行时，选项值显示在呈现的页面中：
选项值 Option1：value1_from_json 和 Option2：-1 从模型中加载并注入视图。

通过 IOptionsSnapshot 重新加载配置数据

通过 IOptionsSnapshot<TOptions> 重新加载配置数据已作为示例 #5 在示例应用中进行了演示。

IOptionsSnapshot<TOptions> 支持包含最小处理开销的重新加载选项。

针对请求生存期访问和缓存选项时，每个请求只能计算一次选项。

以下示例演示如何在更改 appsettings.json (Pages/Index.cshtml.cs) 后创建新的 IOptionsSnapshot<TOptions>。 在更改文件和重新加载配置之前，针对服务器的多个请求返回 appsettings.json 文件提供的常数值。

private readonly MyOptions _snapshotOptions;

public IndexModel(
    IOptionsMonitor<MyOptions> optionsAccessor, 
    IOptionsMonitor<MyOptionsWithDelegateConfig> optionsAccessorWithDelegateConfig, 
    IOptionsMonitor<MySubOptions> subOptionsAccessor, 
    IOptionsSnapshot<MyOptions> snapshotOptionsAccessor, 
    IOptionsSnapshot<MyOptions> namedOptionsAccessor)
{
    _options = optionsAccessor.CurrentValue;
    _optionsWithDelegateConfig = optionsAccessorWithDelegateConfig.CurrentValue;
    _subOptions = subOptionsAccessor.CurrentValue;
    _snapshotOptions = snapshotOptionsAccessor.Value;
    _named_options_1 = namedOptionsAccessor.Get("named_options_1");
    _named_options_2 = namedOptionsAccessor.Get("named_options_2");
}

// Example #5: Snapshot options
var snapshotOption1 = _snapshotOptions.Option1;
var snapshotOption2 = _snapshotOptions.Option2;
SnapshotOptions = 
    $"snapshot option1 = {snapshotOption1}, " +
    $"snapshot option2 = {snapshotOption2}";

下图显示从 appsettings.json 文件加载的初始 option1 和 option2 值：

snapshot option1 = value1_from_json, snapshot option2 = -1

将 appsettings.json 文件中的值更改为 value1_from_json UPDATED 和 200。 保存 appsettings.json 文件。 刷新浏览器，查看更新的选项值：

snapshot option1 = value1_from_json UPDATED, snapshot option2 = 200

包含 IConfigureNamedOptions 的命名选项支持

包含 IConfigureNamedOptions<TOptions> 的命名选项支持已作为示例 #6 在示例应用中进行了演示。

命名选项支持允许应用在命名选项配置之间进行区分。 在示例应用中，命名选项通过 OptionsServiceCollectionExtensions.Configure 进行声明，其调用扩展方法 ConfigureNamedOptions<TOptions>.Configure：

// Example #6: Named options (named_options_1)
// Register the ConfigurationBuilder instance which MyOptions binds against.
// Specify that the options loaded from configuration are named
// "named_options_1".
services.Configure<MyOptions>("named_options_1", Configuration);

// Example #6: Named options (named_options_2)
// Specify that the options loaded from the MyOptions class are named
// "named_options_2".
// Use a delegate to configure option values.
services.Configure<MyOptions>("named_options_2", myOptions =>
{
    myOptions.Option1 = "named_options_2_value1_from_action";
});

示例应用通过 Get(Pages/Index.cshtml.cs) 访问命名选项：

private readonly MyOptions _named_options_1;
private readonly MyOptions _named_options_2;

public IndexModel(
    IOptionsMonitor<MyOptions> optionsAccessor, 
    IOptionsMonitor<MyOptionsWithDelegateConfig> optionsAccessorWithDelegateConfig, 
    IOptionsMonitor<MySubOptions> subOptionsAccessor, 
    IOptionsSnapshot<MyOptions> snapshotOptionsAccessor, 
    IOptionsSnapshot<MyOptions> namedOptionsAccessor)
{
    _options = optionsAccessor.CurrentValue;
    _optionsWithDelegateConfig = optionsAccessorWithDelegateConfig.CurrentValue;
    _subOptions = subOptionsAccessor.CurrentValue;
    _snapshotOptions = snapshotOptionsAccessor.Value;
    _named_options_1 = namedOptionsAccessor.Get("named_options_1");
    _named_options_2 = namedOptionsAccessor.Get("named_options_2");
}

// Example #6: Named options
var named_options_1 = 
    $"named_options_1: option1 = {_named_options_1.Option1}, " +
    $"option2 = {_named_options_1.Option2}";
var named_options_2 = 
    $"named_options_2: option1 = {_named_options_2.Option1}, " +
    $"option2 = {_named_options_2.Option2}";
NamedOptions = $"{named_options_1} {named_options_2}";

运行示例应用，将返回命名选项：

named_options_1: option1 = value1_from_json, option2 = -1
named_options_2: option1 = named_options_2_value1_from_action, option2 = 5

从配置中提供从 appsettings.json 文件中加载的 named_options_1 值。 通过以下内容提供 named_options_2 值：

  • 针对 Option1 的 ConfigureServices 中的 named_options_2 委托。
  • MyOptions 类提供的 Option2 的默认值。

使用 ConfigureAll 方法配置所有选项

使用 ConfigureAll方法配置所有选项实例。 以下代码将针对包含公共值的所有配置实例配置 Option1。 将以下代码手动添加到 Startup.ConfigureServices 方法：

services.ConfigureAll<MyOptions>(myOptions => 
{
    myOptions.Option1 = "ConfigureAll replacement value";
});

添加代码后运行示例应用将产生以下结果：

named_options_1: option1 = ConfigureAll replacement value, option2 = -1
named_options_2: option1 = ConfigureAll replacement value, option2 = 5

备注
所有选项都是命名实例。 现有 IConfigureOptions<TOptions> 实例将被视为面向为 string.Empty 的 Options.DefaultName 实例。 IConfigureNamedOptions<TOptions> 还可实现 IConfigureOptions<TOptions>。 IOptionsFactory<TOptions> 的默认实现具有适当地使用每个实例的逻辑。null 命名选项用于面向所有命名实例而不是某一特定命名实例（ConfigureAll 和 PostConfigureAll 使用此约定）。

OptionsBuilder API

OptionsBuilder<TOptions> 用于配置 TOptions 实例。 OptionsBuilder 简化了创建命名选项的过程，因为它只是初始 AddOptions<TOptions>(string optionsName) 调用的单个参数，而不会出现在所有后续调用中。 选项验证和接受服务依赖关系的 ConfigureOptions 重载仅可通过 OptionsBuilder 获得。

// Options.DefaultName = "" is used.
services.AddOptions<MyOptions>().Configure(o => o.Property = "default");

services.AddOptions<MyOptions>("optionalName")
    .Configure(o => o.Property = "named");

配置 <TOptions、TDep1、...TDep4> 方法

使用 DI 中的服务，通过以样本方式实现 IConfigure[Named]Options 来配置选项的方法非常详细。 OptionsBuilder<TOptions> 上 ConfigureOptions 的重载允许使用最多五个服务来配置选项：

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

重载会注册临时通用 IConfigureNamedOptions<TOptions>，它具有接受指定的通用服务类型的构造函数。

选项验证

借助选项验证，可以验证已配置的选项。 使用验证方法调用 Validate。如果选项有效，方法返回 true；如果无效，方法返回 false：

// Registration
services.AddOptions<MyOptions>("optionalOptionsName")
    .Configure(o => { }) // Configure the options
    .Validate(o => YourValidationShouldReturnTrueIfValid(o), 
        "custom error");

// Consumption
var monitor = services.BuildServiceProvider()
    .GetService<IOptionsMonitor<MyOptions>>();
  
try
{
    var options = monitor.Get("optionalOptionsName");
}
catch (OptionsValidationException e) 
{
   // e.OptionsName returns "optionalOptionsName"
   // e.OptionsType returns typeof(MyOptions)
   // e.Failures returns a list of errors, which would contain 
   //     "custom error"
}

上面的示例将命名选项实例设置为 optionalOptionsName。 默认选项实例为 Options.DefaultName。

选项验证在选项实例创建后运行。 系统保证在选项实例首次获得访问时通过验证。

重要
选项验证无法防止在最初配置和验证选项后发生选项修改。

Validate 方法接受 Func<TOptions, bool>。 若要完全自定义验证，请实现 IValidateOptions<TOptions>，它支持：

  • 验证多种类型的选项：class ValidateTwo : IValidateOptions<Option1>, IValidationOptions<Option2>
  • 验证取决于其他选项类型：public DependsOnAnotherOptionValidator(IOptionsMonitor<AnotherOption> options)

IValidateOptions 验证：

  • 特定的命名选项实例。
  • 所有选项（如果 name 为 null 的话）。

通过接口实现返回 ValidateOptionsResult：

public interface IValidateOptions<TOptions> where TOptions : class
{
    ValidateOptionsResult Validate(string name, TOptions options);
}

通过调用 OptionsBuilder<TOptions> 上的 ValidateDataAnnotations 方法，可以从 Microsoft.Extensions.Options.DataAnnotations 包中获得基于数据注释的验证。Microsoft.AspNetCore.App 元包（ASP.NET Core 2.2 或更高版本）中包括 Microsoft.Extensions.Options.DataAnnotations。

private class AnnotatedOptions
{
    [Required]
    public string Required { get; set; }

    [StringLength(5, ErrorMessage = "Too long.")]
    public string StringLength { get; set; }

    [Range(-5, 5, ErrorMessage = "Out of range.")]
    public int IntRange { get; set; }
}

[Fact]
public void CanValidateDataAnnotations()
{
    var services = new ServiceCollection();
    services.AddOptions<AnnotatedOptions>()
        .Configure(o =>
        {
            o.StringLength = "111111";
            o.IntRange = 10;
            o.Custom = "nowhere";
        })
        .ValidateDataAnnotations();

    var sp = services.BuildServiceProvider();

    var error = Assert.Throws<OptionsValidationException>(() => 
        sp.GetRequiredService<IOptionsMonitor<AnnotatedOptions>>().Value);
    ValidateFailure<AnnotatedOptions>(error, Options.DefaultName, 1,
        "DataAnnotation validation failed for members Required " +
            "with the error 'The Required field is required.'.",
        "DataAnnotation validation failed for members StringLength " +
            "with the error 'Too long.'.",
        "DataAnnotation validation failed for members IntRange " +
            "with the error 'Out of range.'.");
}

设计团队正在考虑为未来版本提供预先验证（在启动时快速失败）。

选项后期配置

使用 IPostConfigureOptions<TOptions> 设置后期配置。 进行所有 IConfigureOptions<TOptions> 配置后运行后期配置：

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

PostConfigure可用于对命名选项进行后期配置：

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

使用 PostConfigureAll对所有配置实例进行后期配置：

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

在启动期间访问选项

IOptions<TOptions> 和 IOptionsMonitor<TOptions> 可用于 Startup.Configure 中，因为在 Configure 方法执行之前已生成服务。

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

不使用 Startup.ConfigureServices 中的 IOptions<TOptions> 或 IOptionsMonitor<TOptions>。 由于服务注册的顺序，可能存在不一致的选项状态。

.NET Core 加载配置 services.Configure() 和 services.AddOptions().Bind() 的区别
weixin_47270410的博客
08-23 2816
OptionsBuilder.Bind(IConfiguration config) 实际上会直接调用 Configure(IConfiguration config)，所以它们也是等价的，所以这两个 API 是可以互换的，后来出现并允许更多的自定义项。两种情况下都能正常获取的。
因果推断视角下的CV模型鲁棒性：从关联学习到因果特征解耦
最新发布
weixin_30918633的博客
05-10 506
在深度学习与计算机视觉领域，模型的泛化能力与鲁棒性是核心挑战。传统监督学习模型本质上是高效的关联性学习机，它们通过拟合数据中的统计规律进行预测。然而，这种学习范式存在根本性局限：模型容易依赖数据中存在的虚假关联特征（如背景、光照、纹理模式）而非物体本质的因果特征进行决策。当输入数据遭遇自然扰动（如光照变化、天气条件、图像压缩）时，这些虚假关联被打破，导致模型性能急剧下降，引发鲁棒性危机。为构建更可靠、可解释的AI系统，研究者引入因果推断框架，通过结构因果模型区分因果特征与非因果特征，并运用干预思想来诊断和增
ASP.NET Core 基础知识
飞鸟慕鱼的博客
10-22 1571
Startup类 Startup类 1.ConfigureServices：配置（注册）引用的服务。服务是一个提供应用功能的可重用组件 2.Configure：创建应用的请求处理管道 3.在应用启动时，ANC运行时会调用ConfigureServices和Configure 4.主机提供Startup类构造函数可用的某些服务，应用通过ConfigureServices添加其他服务，主机和...
ASP.NET Core 配置源：实时生效
dotNET跨平台
04-20 669
在之前的文章 ASP.NET Core 自定义配置源 和 ASP.NET Core etcd 配置源 中主要是介绍如何实现自定义的配置源，但不论内置的和自定义的配置源，都会面临如何使配置...
小谈startup类ConfigureServices方法的作用
喵叔
11-28 1729
这个是我在面试中遇到的一道面试题，记录下来分享给大家。 简单说ConfigureServices是配置服务器的DI容器，可以添加一些服务进到依赖注入容器中。具体来说就是把中间件等添加到DI容器中，最后都是添加到IServiceCollection中，比如下面的代码： services.AddIdentityServer() .AddDeveloperSigningCredential() .AddInMemoryApiResources(Config.GetResource()) .AddIn
.net6怎样注册服务，配置服务，使用服务？services.confgure方法是干啥的？
lllljz的专栏
03-29 1297
.net服务三部曲：1.注册（实例化或依赖注入），2.配置（载入配置文件或写入程序），3.使用服务
ASP.NET Core 2.2 基础知识(七) 选项模式
weixin_33836874的博客
01-06 164
原文:ASP.NET Core 2.2 基础知识(七) 选项模式承接上一篇 配置, 选项模式是专门用类来表示相关配置的服务. 基本选项配置 新建一个选项类,该类必须是包含无参数的构造函数的非抽象类. public class MyOptions { public MyOptions() { Id = 1; ...
.NetCore选项数据热更新
hahahzzzzz的博客
07-19 615
1. 关键类型 IOptionsMonitor<outTOptions> IOptionsSnapshot<outTOptions> 2. 场景 范围作用域类型（AddScoped）使用 IOptionsSnapshot 单例服务（AddSingleton）使用IOptionsMonitor 3. 通过代码更新选项 IPostConfigureOptions<TOptions> 4.IOptionsSnapshot热更新代码 public i...
ASP.NET Core中ConfigureServices和Configure的作用
Gene Z.的博客
03-25 922
通过这两个方法，ASP.NET Core实现了。的解耦，为应用提供了高度可定制的启动流程。方法是应用初始化的核心，分别用于。在ASP.NET Core中，
（四）.net core之应用配置、多环境配置、日志与路由
lwy
11-16 964
应用配置、多环境配置、日志与路由
避免在ASP.NET Core 3.0中为启动类注入服务
终极冥帝
01-15 453
原文： https://andrewlock.net/avoiding-startup-service-injection-in-asp-net-core-3/ 作者： Andrew Lock 译者： Lamond Lu 本篇是如何升级到ASP.NET Core 3.0系列文章的第二篇。 Part 1 - 将.NET Standard 2.0类库转换为.NET Core 3.0类库...
加载appsettings.json文件
ccvah的博客
04-18 266
在控制台应用项目下，创建appsettings.json。创建调用类及调用方式。
.net core 实践篇—————服务与配置之间[十一二]
weixin_45032957的博客
06-07 685
服务: public interface ISelfService { string ShowOptionName(); } public class SelfService : ISelfService { IOptions _options; public SelfService(IOptions options) { this._options = options; } public string ShowOptionName() { return _options.Value.Name; } } 实
ASP.NET Core 3.0 : 二十四. 配置的Options模式
weixin_30915951的博客
09-27 1094
上一章讲到了配置的用法及内部处理机制，对于配置，ASP.NET Core还提供了一种Options模式。(ASP.NET Core 系列目录) 一、Options的使用 上一章有个配置的绑定的例子，可以将配置绑定到一个Theme实例中。也就是在使用对应配置的时候，需要进行一次绑定操作。而Options模式提供了更直接的方式，并且可以通过依赖注入的方式提供配置的读取。下文中称每一条Op...
【.Net Core】ConfigureServices和Configure
欢迎指错||纠正||建议||水评+点赞&&评论&&关注&&转发
06-26 1070
在ASP.NET Core应用程序中，`ConfigureServices` 和 `Configure` 是两个在 `Startup` 类中非常重要的方法，它们分别在服务配置和请求处理管道配置中起关键作用。
java向word模板写入数据
zhen89641的博客
09-03 1247
其中ycList，就是你在word中定义的list，直接看图。在需要编译的空格中，使用{{}}双花括号来代替，集合使用{{}}，集合里面的属性用[]中括号。至于列表的动态添加行，需要引用到。使用poi-tl包，首选引入包。
.Net Core 3.1 Web API基础知识
weixin_45032957的博客
09-27 1281
在Startup类的ConfigureServices方法内添加以下注入代码： 复制代码 services.AddSwaggerGen(c => { c.SwaggerDoc(“v1”, new OpenApiInfo { Title = “My API”, Version = “v1”, Description = “API文档描述”, Contact = new OpenApiContact { Email = “5007032@qq.com”, Name = “测试项目”, //Url = ne
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值