如何在Blazor中实现全局变量以动态配置帮助文档基础URL

实现方案 #

你用的是带Razor语法的Blazor技术栈（搭配DevExpress组件），可以按照以下3步实现全局帮助域名配置：

1. 配置多环境域名 #

有两种配置方式可选，推荐第二种更灵活：

方案A：代码直接写死环境判断

根据你用的Blazor类型修改Program.cs：

• Blazor Server 版本：

// 开发环境用本地地址，生产环境用正式域名
var baseHelpUrl = builder.Environment.IsDevelopment() 
    ? "http://localhost:你的开发端口" 
    : "https://你的正式帮助文档域名";
// 注册为全局单例
builder.Services.AddSingleton(baseHelpUrl);

• Blazor WASM 版本：

var baseHelpUrl = builder.HostEnvironment.IsDevelopment()
    ? "http://localhost:你的开发端口"
    : "https://你的正式帮助文档域名";
builder.Services.AddSingleton(baseHelpUrl);

方案B：配置文件读写（推荐）

不用修改代码，根据环境自动加载对应配置：

开发环境配置：编辑appsettings.Development.json添加字段

{
  "BaseHelpUrl": "http://localhost:你的开发端口"
}

生产环境配置：编辑appsettings.Production.json添加字段

{
  "BaseHelpUrl": "https://你的正式帮助文档域名"
}

然后在Program.cs里读取配置并注册：

var baseHelpUrl = builder.Configuration.GetValue<string>("BaseHelpUrl");
builder.Services.AddSingleton(baseHelpUrl);

2. 全局注入变量 #

打开项目根目录的_Imports.razor文件，添加注入代码，所有Razor页面就可以直接调用变量，不用每页重复注入：

@inject string base_help_url

3. 替换原有硬编码链接 #

把所有DxToolbarItem里的硬编码域名替换成变量拼接即可，示例：

<DxToolbarItem 
    Text="Help" 
    NavigateUrl="@($"{base_help_url}/help/group1/feature001/")" 
    IconCssClass="grid-toolbar-document" 
    target="_blank" />

其他页面的路径按照同样规则替换，只需要修改域名部分，后面的/help/xxx/路径保持原样即可。

小提示：如果担心拼接时斜杠重复/缺失，可以用Uri类做更可靠的拼接：

NavigateUrl="@(new Uri(new Uri(base_help_url), "/help/group1/feature001/").ToString())"

内容的提问来源于stack exchange，提问作者Đỗ Như Vỹ