推荐使用 NavigationManager 结合 QueryHelpers 解析查询字符串,通过注入 NavigationManager 获取 Uri 并解析为字典,安全读取参数值,该方法兼容 Blazor Server 和 WebAssembly。

在 Blazor 中获取 URL 查询字符串参数,主要取决于你使用的是 Blazor WebAssembly(WASM) 还是 Blazor Server,但核心思路一致:通过导航状态或 HTTP 上下文提取查询参数。最常用、推荐的方式是利用 NavigationManager 解析当前 URL。
使用 NavigationManager 获取查询参数(推荐,适用于所有 Blazor 类型)
NavigationManager 是 Blazor 内置的跨平台导航服务,它提供 Uri 属性,可直接读取当前地址栏 URL。你可以手动解析查询字符串,或借助 .NET 内置的 QueryString 工具类。
- 在组件中注入
@inject NavigationManager Navigation - 在
OnInitialized或OnParametersSet中获取完整 URI:var uri = new Uri(Navigation.Uri) - 用
Microsoft.AspNetCore.WebUtilities.QueryHelpers.ParseQuery(uri.Query)解析为IDictionary - 安全读取值:例如
query.TryGetValue("id", out var idValue) ? idValue.ToString() : null
在路由组件中配合 @page 指令传参(仅限路由路径参数,非查询参数)
注意区分:@page "/product/{id:int}" 是 路由参数(path parameter),不是查询字符串(如 ?category=books&sort=date)。它不适用于 ?key=value 形式。若需同时支持,建议组合使用:路由参数 + 查询字符串解析。
Blazor Server 中可选:从 HttpContext 获取(仅限服务端上下文)
在 Blazor Server 的 OnInitializedAsync 中,如果启用了 HttpContext 访问(需配置 AddServerSideBlazor().AddCircuitOptions(...) 并启用上下文传播),可通过 HttpContext.Request.Query["key"] 直接读取。但该方式耦合性强、不可用于 WASM,**不推荐作为通用方案**。
封装成可复用方法(提升可维护性)
建议将解析逻辑抽成扩展方法或服务,例如:
public static class NavigationExtensions
{
public static Dictionary GetQueryParameters(this NavigationManager nav)
{
var uri = new Uri(nav.Uri);
return QueryHelpers.ParseQuery(uri.Query)
.ToDictionary(kvp => kvp.Key, kvp => kvp.Value.ToString());
}
}
然后在组件中调用:var query = Navigation.GetQueryParameters();,简洁又安全。
基本上就这些。只要记住:优先用 NavigationManager + QueryHelpers,兼容性好、无依赖、一行 URL 就能解析,不复杂但容易忽略细节(比如没处理空值或编码)。










