Blazor IConfiguration 读取配置信息教程

苏承栈

2026-10-06 • 👁 0人浏览过

Blazor应用读取配置需区分环境：Server端支持完整ASP.NET Core配置模型，可注入IConfiguration读取appsettings.json等；WASM端仅支持wwwroot下静态JSON文件，不支持动态配置源，敏感信息须由后端提供。 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()

提升可维护性 Blazor WebAssembly 中 IConfiguration 的限制它运行在浏览器沙箱中，无法访问服务器文件系统或环境变量。默认只加载

wwwroot/appsettings.json

（及对应环境变体如

appsettings.Development.json

），且仅限静态 JSON 文件。 Comet AI 浏览器下载 Comet AI 浏览器，体验由 Perplexity AI 驱动的革命性上网方式。内置 AI 助手可实时总结网页、跨标签页对比信息、自动执行任务。告别繁琐操作，让 AI 成为你的浏览副驾，大幅提升研究与工作效率。支持 Windows、macOS、Android 和 iOS。下载确保

appsettings.json

已放在

wwwroot

目录下，并设置为“内容”+“复制到输出目录” 启动时框架自动加载，

IConfiguration

可正常注入和使用，方式与 Server 端一致不支持从数据库、Azure Key Vault、自定义 Provider 动态加载配置——必须提前打包进前端资源敏感信息（如 API 密钥）绝不能写在

appsettings.json

中，应由后端 API 统一鉴权返回跨平台统一读取技巧（Server + WASM 兼容）若项目同时支持两种托管模型，可通过抽象配置逻辑避免重复判断。定义共享配置接口（如

IAppSettings

）和实现类，按环境注入不同实现在

Program.cs

中区分注册：

builder.Services.AddSingleton()

或

WasmAppSettings

业务组件只依赖接口，不关心底层如何读取，提升可测试性和可移植性基本上就这些。关键是分清运行环境，别在 WASM 里尝试读取

appsettings.Production.json

却忘了把它发布到

wwwroot

下——配置不会自动“找得到”，得你亲手放对位置。

相关文章