0

0

ASP.NET Core 的选项模式如何管理配置?

畫卷琴夢

畫卷琴夢

发布时间:2025-09-29 09:32:01

|

752人浏览过

|

来源于php中文网

原创

ASP.NET Core 选项模式通过 IOptions 将 appsettings.json 配置绑定到强类型类,提升代码可维护性与类型安全;定义 SmtpSettings 类映射配置节,使用 Configure 绑定,依赖注入获取值,并可通过数据注解或 FluentValidation 验证配置有效性。

asp.net core 的选项模式如何管理配置?

ASP.NET Core 的选项模式通过依赖注入和强类型配置类,把应用的配置数据组织得更清晰、更安全。它不只是读取 appsettings.json 里的值,而是把配置映射到具体的 C# 类中,让代码更容易维护和测试。

定义选项类

要使用选项模式,先创建一个普通 C# 类来表示你的配置结构。这个类应该是简单的 POCO(Plain Old CLR Object)。

比如你有如下 JSON 配置:

appsettings.json
{
  "SmtpSettings": {
    "Server": "smtp.example.com",
    "Port": 587,
    "Username": "user@example.com"
  }
}

对应定义一个选项类:

public class SmtpSettings
{
    public string Server { get; set; }
    public int Port { get; set; }
    public string Username { get; set; }
}

在启动时绑定配置

Program.csStartup.cs 中,使用 ConfigureServices 方法将配置绑定到选项类。

在 ASP.NET Core 6+ 的 Minimal API 风格中:

var builder = WebApplication.CreateBuilder(args);

// 添加选项服务,并绑定到 SmtpSettings builder.Services.Configure( builder.Configuration.GetSection("SmtpSettings") );

这样就把 appsettings.json 中的 "SmtpSettings" 节点自动映射到了 SmtpSettings 类上。

在服务或控制器中使用选项

通过依赖注入获取配置值。推荐使用 IOptions 接口。

public class EmailService
{
    private readonly SmtpSettings _settings;
public EmailService(IOptions options)
{
    _settings = options.Value;
}

public void Send()
{
    Console.WriteLine($"Connecting to {_settings.Server}:{_settings.Port}");
}

}

造次
造次

Liblib打造的AI原创IP视频创作社区

下载

注册该服务:

builder.Services.AddTransient();

如果配置在运行时可能变化,可以使用 IOptionsSnapshot作用域内生效)或 IOptionsMonitor(支持变更通知)。

验证配置有效性

你可以添加数据注解来验证选项是否正确加载。

using System.ComponentModel.DataAnnotations;

public class SmtpSettings { [Required] public string Server { get; set; }

[Range(1, 65535)]
public int Port { get; set; }

[EmailAddress]
public string Username { get; set; }

}

然后在绑定后主动验证:

var configuration = builder.Configuration;
var smtpConfig = configuration.GetSection("SmtpSettings");
var settings = new SmtpSettings();
smtpConfig.Bind(settings);

var validationContext = new ValidationContext(settings); Validator.ValidateObject(settings, validationContext, validateAllProperties: true);

或者用第三方库如 FluentValidation 实现更复杂的校验逻辑。

基本上就这些。选项模式让配置不再是零散的字符串查找,而是变成可测试、可验证、类型安全的对象模型,提升了整体代码质量。

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

412

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

533

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

310

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

74

2025.09.10

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

258

2023.08.03

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

208

2023.09.04

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

1465

2023.10.24

字符串介绍
字符串介绍

字符串是一种数据类型,它可以是任何文本,包括字母、数字、符号等。字符串可以由不同的字符组成,例如空格、标点符号、数字等。在编程中,字符串通常用引号括起来,如单引号、双引号或反引号。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

619

2023.11.24

高德地图升级方法汇总
高德地图升级方法汇总

本专题整合了高德地图升级相关教程,阅读专题下面的文章了解更多详细内容。

72

2026.01.16

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WEB前端教程【HTML5+CSS3+JS】
WEB前端教程【HTML5+CSS3+JS】

共101课时 | 8.4万人学习

JS进阶与BootStrap学习
JS进阶与BootStrap学习

共39课时 | 3.2万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号