ASP.NET Razor Pages中page参数绑定与路由生成异常求助

问题原因分析 #

你遇到的两个问题其实都和Razor Pages的保留参数名称有关：

• page是Razor Pages框架的保留路由参数，用来指定要渲染的页面路径，所以当你使用asp-route-page时，框架会把它当成页面路由的一部分，而不是你想要的查询字符串参数，导致生成的URL里没有带上page=X。
• 同样，因为page是保留参数，框架在绑定请求参数时，会优先处理自身的page逻辑，不会把URL中?page=X的值绑定到你OnGet方法里的page参数上，所以你的参数始终是int类型的默认值0。

解决方案 #

1. 让锚点标签助手生成正确的带page参数的URL

最稳妥的方式是修改自定义参数的名称，避开保留字，比如改成pageNum或者currentPage：

<a asp-page="Dataset" asp-route-id="@dataset.Id" asp-route-pageNum="@pageNumber">@dataset.Title</a>

这样生成的URL就会是http://example.com/Dataset/0?pageNum=X，完全符合你的需求。

如果一定要保留page作为查询参数名，可以手动拼接URL（虽然麻烦，但能解决冲突）：

<a href="@($"{Url.Page("Dataset", new { id = dataset.Id })}?page={pageNumber}")">@dataset.Title</a>

2. 修复OnGet方法中page参数绑定失效的问题

同样，优先推荐修改参数名称，和前端保持一致，比如改成pageNum：

public FileResult OnGet(int id, string subject, string predicate, string @object, int pageNum) {
    // 现在URL中的?pageNum=30会正确绑定到这里的pageNum参数
}

如果必须保留page作为参数名，可以通过[FromQuery]特性强制指定绑定的查询参数名（不推荐，避免后续潜在冲突）：

public FileResult OnGet(int id, string subject, string predicate, string @object, [FromQuery(Name = "page")] int page) {
    // 强制从查询字符串绑定page参数，此时URL中的?page=30会正确赋值
}

额外提示 #

Razor Pages还有一些其他的保留参数名称，比如handler、area、controller等，在自定义参数时尽量避开这些名称，避免出现类似的路由冲突或参数绑定问题。

内容的提问来源于stack exchange，提问作者nubi