You need to enable JavaScript to run this app. Razor Page中如何通过锚点asp-route向Controller传递字符串路由参数
优惠活动
大模型
产品
解决方案
定价
更多

Razor Page中如何通过锚点asp-route向Controller传递字符串路由参数

Razor Page 传递字符串类型路由参数的实现方法

asp-route-*系列标签助手本身不限制路由值的类型,只要移除不必要的整数路由约束,直接替换传参值即可。

很多人误以为asp-route-id只能传递整数,实际上这个标签助手的作用是把指定的路由值填充到路由模板中对应名称的参数位置,值的类型完全由路由模板的约束和Action的形参决定,和标签助手本身无关。

1. 锚点标签的传参写法

不需要更换asp-route-id属性名,直接把原本传整数的位置替换为实际要传递的字符串值即可:

<!-- 原本传递整数的写法 -->
<a asp-controller="Order" asp-action="Query" asp-route-id="1024">订单详情</a>
<!-- 传递字符串的写法,直接替换id参数值 -->
<a asp-controller="Order" asp-action="Query" asp-route-id="pending-orders">待处理订单</a>

标签助手会自动生成对应格式的路由路径Order/Query/pending-orders,完全匹配controller-name/method-name/string的目标形式,过程中会自动处理字符串的URL编码,不需要手动转义特殊字符。

2. 移除会导致匹配失败的整数路由约束

这是实操中最容易踩的坑:

  • 如果你的全局路由模板使用默认的{controller=Home}/{action=Index}/{id?}定义,本身没有对id参数做类型限制,天然支持字符串传参,不需要额外修改
  • 如果之前为整数传参在路由配置中加了强制类型约束,必须移除约束才能正常匹配:
    • 全局路由里如果写了类似{id:int}的定义,要删掉:int约束
    • Action方法上如果加了类似[Route("Query/{id:int}")]的特性路由,也要删掉:int约束
    • Action方法的形参类型要和传递的字符串匹配,把原本的int id改成string id

举个正确的Action定义示例:

[HttpGet]
[Route("Query/{id}")] // 注意不要加:int强制类型约束
public IActionResult Query(string id) // 形参类型改为string
{
    // 业务逻辑处理
    return View();
}

注意:如果保留了int类型的路由约束,即使标签里传了字符串值,框架也会判定路由不匹配,直接返回404错误。


内容的提问来源于stack exchange,提问作者Asad Mirza

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.11 22:24:09