Blazor IConfiguration 读取配置信息教程

来源:这里教程网 时间:2026-02-21 17:34:19 作者:

Blazor 应用中读取配置信息,核心是通过

IConfiguration
接口获取,但要注意:服务端渲染(Blazor Server)和客户端渲染(Blazor WebAssembly)的配置加载机制完全不同,不能混用。

Blazor Server 中使用 IConfiguration

它运行在 .NET 后端,完全支持标准 ASP.NET Core 配置模型,可直接注入

IConfiguration
读取
appsettings.json
、环境变量、命令行参数等。

Program.cs
Startup.cs
中已自动注册,无需额外操作
在组件(.razor)中按需注入:
@inject IConfiguration Configuration
读取示例:
@Configuration["Logging:LogLevel:Default"]
@Configuration.GetSection("ConnectionStrings")["Default"]
推荐封装为强类型配置类,用
Configuration.GetSection("MyOptions").Get<myoptions>()</myoptions>
提升可维护性

Blazor WebAssembly 中 IConfiguration 的限制

它运行在浏览器沙箱中,无法访问服务器文件系统或环境变量。默认只加载

wwwroot/appsettings.json
(及对应环境变体如
appsettings.Development.json
),且仅限静态 JSON 文件。

确保
appsettings.json
已放在
wwwroot
目录下,并设置为“内容”+“复制到输出目录”
启动时框架自动加载,
IConfiguration
可正常注入和使用,方式与 Server 端一致
不支持从数据库、Azure Key Vault、自定义 Provider 动态加载配置——必须提前打包进前端资源 敏感信息(如 API 密钥)绝不能写在
appsettings.json
中,应由后端 API 统一鉴权返回

跨平台统一读取技巧(Server + WASM 兼容)

若项目同时支持两种托管模型,可通过抽象配置逻辑避免重复判断。

定义共享配置接口(如
IAppSettings
)和实现类,按环境注入不同实现
Program.cs
中区分注册:
builder.Services.AddSingleton<iappsettings serverappsettings>()</iappsettings>
WasmAppSettings
业务组件只依赖接口,不关心底层如何读取,提升可测试性和可移植性

基本上就这些。关键是分清运行环境,别在 WASM 里尝试读取

appsettings.Production.json
却忘了把它发布到
wwwroot
下——配置不会自动“找得到”,得你亲手放对位置。

相关推荐