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);
<p>// 添加选项服务,并绑定到 SmtpSettings
builder.Services.Configure<SmtpSettings>(
builder.Configuration.GetSection("SmtpSettings")
);</p>

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

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

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

public class EmailService
{
    private readonly SmtpSettings _settings;
<pre class="brush:php;toolbar:false;">public EmailService(IOptions<SmtpSettings> options)
{
    _settings = options.Value;
}

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

}

皮卡智能
皮卡智能

AI驱动高效视觉设计平台

下载

注册该服务:

builder.Services.AddTransient<EmailService>();

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

验证配置有效性

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

using System.ComponentModel.DataAnnotations;
<p>public class SmtpSettings
{
[Required]
public string Server { get; set; }</p><pre class="brush:php;toolbar:false;">[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);
<p>var validationContext = new ValidationContext(settings);
Validator.ValidateObject(settings, validationContext, validateAllProperties: true);</p>

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

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

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

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

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

455

2023.08.07

json是什么
json是什么

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

546

2023.08.23

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

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

334

2023.10.13

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

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

82

2025.09.10

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

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

760

2023.08.03

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

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

221

2023.09.04

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

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

1566

2023.10.24

字符串介绍
字符串介绍

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

649

2023.11.24

C# ASP.NET Core微服务架构与API网关实践
C# ASP.NET Core微服务架构与API网关实践

本专题围绕 C# 在现代后端架构中的微服务实践展开,系统讲解基于 ASP.NET Core 构建可扩展服务体系的核心方法。内容涵盖服务拆分策略、RESTful API 设计、服务间通信、API 网关统一入口管理以及服务治理机制。通过真实项目案例,帮助开发者掌握构建高可用微服务系统的关键技术,提高系统的可扩展性与维护效率。

3

2026.03.11

热门下载

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

精品课程

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

共101课时 | 10.1万人学习

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

共39课时 | 3.3万人学习

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

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