如何在ASP.NET Core MVC中通过链接传递数据至控制器动作方法

在ASP.NET Core MVC项目开发中，通过链接传递数据是前后端交互的常见场景，比如点击列表项跳转到详情页时传递ID，或者跳转时携带筛选条件等。掌握不同的传参方式以及对应的接收逻辑，能让开发工作更高效。

一、通过路由参数传递数据

路由参数是最常用的传参方式之一，需要在路由模板中定义对应的参数占位符，点击链接时传递的参数会按照路由规则匹配到动作方法的参数上。

1. 定义带参数的路由

首先在Program.cs中定义支持参数的路由，示例代码如下：

// 定义带id参数的路由模板
app.MapControllerRoute(
    name: "default",
    pattern: "{controller=Home}/{action=Index}/{id?}");

2. 生成带路由参数的链接

在视图页面中，可以使用asp-controller、asp-action和asp-route-参数名标签辅助器生成带路由参数的链接，示例代码如下：

<a asp-controller="Product" asp-action="Detail" asp-route-id="1001">查看商品1001详情</a>

生成的链接地址为/Product/Detail/1001，其中1001就是路由参数id的值。

3. 控制器动作方法接收参数

在对应的控制器动作方法中，定义和路由参数同名的参数即可接收数据，示例代码如下：

public class ProductController : Controller
{
    // 动作方法参数id和路由中的id参数对应
    public IActionResult Detail(int id)
    {
        // 使用接收到的id查询商品数据
        ViewBag.ProductId = id;
        return View();
    }
}

二、通过查询字符串传递数据

查询字符串适合传递多个可选参数，不需要修改路由模板，参数会拼接在URL的?后面，格式为?参数名=参数值&参数名=参数值。

1. 生成带查询字符串的链接

同样使用标签辅助器，通过asp-route-参数名定义多个参数，框架会自动拼接为查询字符串，示例代码如下：

<a asp-controller="Product" asp-action="List" asp-route-category="电子数码" asp-route-page="2">查看电子数码类第2页商品</a>

生成的链接地址为/Product/List?category=电子数码&page=2。

2. 控制器接收查询字符串参数

动作方法的参数名和查询字符串的参数名一致即可自动接收，示例代码：

public class ProductController : Controller
{
    public IActionResult List(string category, int page = 1)
    {
        // 接收查询字符串传递的分类和页码参数
        ViewBag.Category = category;
        ViewBag.Page = page;
        return View();
    }
}

三、两种传参方式的对比

两种传参方式各有适用场景，具体差异如下：

四、注意事项

• 路由参数如果定义为必填（路由模板中不带?），传递链接时必须携带对应参数，否则会匹配不到动作方法。
• 参数类型要匹配，比如动作方法参数是int类型，传递的参数必须是数字，否则会触发参数绑定失败。
• 如果需要传递复杂对象，建议通过查询字符串传递多个基础类型参数，或者使用表单提交，链接传参更适合简单数据场景。

以上就是ASP.NET Core MVC中通过链接传递数据到控制器动作方法的常用方式，开发者可以根据实际业务场景选择合适的传参方式，结合示例代码快速实现功能。

ASP.NET_Core_MVC控制器动作方法链接传参路由参数查询字符串修改时间：2026-06-04 18:19:39