Blazor 怎么获取 URL 查询字符串参数

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

在 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<string stringvalues></string>
安全读取值:例如
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<string, string> 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 就能解析,不复杂但容易忽略细节(比如没处理空值或编码)。

相关推荐