如何在.NETCore中使用IOptions读取appset...

程序员有二十年 2024-08-25 13:35:07

有多种方法可以从 .NET Core 项目中的 appsettings.json 文件中读取配置设置。在本文中,我将告诉你如何在 .NET Core 项目中使用 IOptions 读取appsettings.json文件内容。

在 C# 和 .NET Core 领域,配置管理对于确保应用程序灵活且易于配置至关重要。

在 .NET Core 项目中,配置设置通常存储在appsettings.json文件中。

在读取 appsettings.json 文件中的配置设置时,IOptions 作为选项之一发挥作用。

IOptions 是一种机制,允许您对应用程序的配置数据进行类型保护和检索。

什么是 IOptions?

IOptions<T> 接口允许在 .NET Core 中以强类型方式使用配置数据。表示将在其中存储配置数据的特殊类。此类通常用于对文件appsettings.json中的数据进行建模。

IOptions 用于以下方案:

访问配置数据: 当您需要在整个应用程序的不同位置使用它们时,它用于检索和使用存储在具有强大类型的配置文件中的设置。

确保类型安全: 将配置设置绑定到特定类,在使用设置时启用编译时错误检查。这样可以防止拼写错误和类型不兼容。

集中管理: 它允许从一个中心点管理应用程序的不同组件之间的通用设置。这可确保在进行配置更改时,它们会在整个应用程序中自动更新。

IOptions的使用通常分三个步骤进行。

让我通过我为理解这个主题而准备的样本项目来解释我们将做什么。我将在本文的其余部分分享链接以访问该项目的源代码。

因此,让我们继续这个项目。

在下面,您将找到项目的文件夹结构。

示例项目的文件夹结构

我提到过有不同的方法可以读取appsettings.json文件。除了 IOptions,还可以使用使用依赖注入或模型类的访问方法。

默认情况下,.NET Core 在项目创建阶段已创建项目中的 appsettings.json 文件。您还可以在下面查看文件的内容。由于这是一个学习项目,所以我在数据库和连接字符串等领域编写了测试文本。当然,在实际项目中,这些区域需要适当更新。

{ "Logging": { "LogLevel": { "Default": "Information", "Microsoft.AspNetCore": "Warning" } }, "ApplicationSettings": { "DbConnString": "Using options connection string", "SubSettings": { "Name": "Read appsettings.json using options", "ApiVersion": 3 } } }IOptions 使用情况

它的使用通常分三个步骤进行:

第 1 步 — 配置类定义:

首先,定义一个类来保存配置数据。此类必须与appsettings.json文件中的结构匹配。

我还在项目中创建了一个配置类,如下所示:

public AppsettingsOptionsModel { public string DbConnString { get; set; } public AppsettingsSubsettingsModel? SubSettings { get; set; } } public AppsettingsSubsettingsModel { public string Name { get; set; } public string ApiVersion { get; set; } }

第 2 步 — 将配置添加到服务:

在Program.cs文件中,将添加配置服务并将其链接到配置文件。

builder.Services.Configure<AppsettingsOptionsModel>(builder.Configuration.GetSection("ApplicationSettings"));

第 3 步 — 使用配置:

可以访问 IOptions 配置设置,并在需要时读取数据。

最常见的方法是使用依赖注入来访问 IOptions 接口。

public ReadAppsettingsUsingOptionsController : ControllerBase {private readonly AppsettingsOptionsModel _appSettingsModel;public ReadAppsettingsUsingOptionsController(IOptions<AppsettingsOptionsModel> options) { _appSettingsModel = options.Value; } [HttpGet("ReadConnString")]public IActionResult GetConnectionString() {return Ok(_appSettingsModel.DbConnString); } [HttpGet("ReadAppName")]public IActionResult GetAppName() {return Ok(_appSettingsModel.SubSettings.Name); } [HttpGet("ReadGroupDate")]public IActionResult GetGroupData() {return Ok(_appSettingsModel); } }

现在,让我们运行示例项目并检查结果。

当我们运行项目时,Swagger 界面欢迎我们。

每次触发 endPoint 时,我都会在下面按顺序共享返回的结果。

从 appsettings.json 文件中读取连接字符串值的方法的结果

该方法从appsettings.json文件中读取子节点值的结果

从appsettings.json文件中读取组值的方法的结果

使用 IOptions 读取 appsettings.json 文件具有显著的优势,例如类型安全性、集中管理和灵活性。但是,它也有一些缺点,例如初始成本、过载的配置类以及需要动态更新。因此,对于开发人员来说,根据项目的需求评估 IOptions 的使用情况非常重要。

在大型和复杂的项目中,IOptions 通常是一个很大的好处,而在小型项目中,更简单的配置方法可能就足够了。

如果你喜欢我的文章,请给我一个赞!谢谢

0 阅读:0

程序员有二十年

简介:感谢大家的关注