ASP.NET中如何在URL链接中传递多个可选参数？

1. 重构后端：创建筛选参数ViewModel #

把分散的筛选、排序参数整合到单独的ViewModel类中，统一管理，避免页面模型臃肿：

public class FilterViewModel
{
    public string? SearchString { get; set; }
    public string? First_Name { get; set; }
    public string? Last_Name { get; set; }
    public string? Location { get; set; }
    // 新增其他15+筛选参数
    public string? SortOrder { get; set; }
}

在页面模型中引用这个ViewModel并绑定：

public class IndexModel : PageModel
{
    [BindProperty(SupportsGet = true)]
    public FilterViewModel Filters { get; set; } = new FilterViewModel();

    // 排序字段逻辑统一放在这里
    public string First_Name_Sort => 
        Filters.SortOrder == "first_name_asc" ? "first_name_desc" : "first_name_asc";

    public string Last_Name_Sort => 
        Filters.SortOrder == "last_name_asc" ? "last_name_desc" : "last_name_asc";

    public async Task OnGetAsync()
    {
        // 用Filters参数执行查询与排序逻辑
        // 示例：
        // var query = _db.CourseTaken.AsQueryable();
        // if (!string.IsNullOrEmpty(Filters.SearchString))
        // {
        //     query = query.Where(x => x.First_Name.Contains(Filters.SearchString));
        // }
        // // 其他筛选条件...
        // // 排序逻辑
        // query = Filters.SortOrder switch
        // {
        //     "first_name_asc" => query.OrderBy(x => x.First_Name),
        //     "first_name_desc" => query.OrderByDescending(x => x.First_Name),
        //     _ => query
        // };
    }
}

2. 前端动态生成带所有筛选参数的链接 #

无需手动编写大量asp-route-*，利用RouteValueDictionary自动携带所有筛选参数，仅覆盖需要修改的字段（如SortOrder）。

方式一：直接用Url.Page生成链接 #

表格表头的排序链接可以这样写：

<table>
    <thead>
        <th>
            <a href="@Url.Page("./Index", new RouteValueDictionary(Model.Filters) { { "SortOrder", Model.First_Name_Sort } })">
                @Html.DisplayNameFor(model => model.CourseTakenList[0].First_Name)
            </a>
        </th>
        <th>
            <a href="@Url.Page("./Index", new RouteValueDictionary(Model.Filters) { { "SortOrder", Model.Last_Name_Sort } })">
                @Html.DisplayNameFor(model => model.CourseTakenList[0].Last_Name)
            </a>
        </th>
        <!-- 其他15+列只需替换SortOrder对应的字段即可 -->
    </thead>
    <!-- 表格内容 -->
</table>

RouteValueDictionary(Model.Filters)会自动将所有筛选属性转为路由参数，再替换指定的SortOrder值，确保所有筛选条件不丢失。

方式二：自定义TagHelper（更优雅） #

如果需要更简洁的写法，可自定义TagHelper简化重复代码：

首先创建TagHelper类：

[HtmlTargetElement("a", Attributes = "asp-page, asp-filters, asp-override-*")]
public class FilterLinkTagHelper : AnchorTagHelper
{
    private readonly IUrlHelperFactory _urlHelperFactory;
    private readonly ViewContext _viewContext;

    public FilterLinkTagHelper(IUrlHelperFactory urlHelperFactory, ViewContext viewContext) : base(urlHelperFactory, viewContext)
    {
        _urlHelperFactory = urlHelperFactory;
        _viewContext = viewContext;
    }

    [HtmlAttributeName("asp-filters")]
    public object Filters { get; set; } = null!;

    public override void Process(TagHelperContext context, TagHelperOutput output)
    {
        var urlHelper = _urlHelperFactory.GetUrlHelper(_viewContext);
        var routeValues = new RouteValueDictionary(Filters);

        // 处理所有asp-override-*属性，覆盖路由参数
        foreach (var attribute in context.AllAttributes.Where(a => a.Name.StartsWith("asp-override-")))
        {
            var key = attribute.Name["asp-override-".Length..];
            routeValues[key] = attribute.Value;
        }

        var url = urlHelper.Page(Page, routeValues);
        output.Attributes.SetAttribute("href", url);
        
        base.Process(context, output);
    }
}

在_ViewImports.cshtml中注册TagHelper（替换为你的项目程序集名称）：

@addTagHelper *, YourProjectAssemblyName

之后前端链接可简化为：

<a asp-page="./Index" asp-filters="@Model.Filters" asp-override-SortOrder="@Model.First_Name_Sort">
    @Html.DisplayNameFor(model => model.CourseTakenList[0].First_Name)
</a>

3. 筛选输入框绑定调整 #

将输入框绑定到ViewModel的属性：

<input type="text" asp-for="Filters.SearchString" />
<input type="text" asp-for="Filters.First_Name" />
<input type="text" asp-for="Filters.Last_Name" />
<input type="text" asp-for="Filters.Location" />
<!-- 其他筛选输入框同理 -->

提交表单时所有筛选参数会自动绑定到Filters对象，与后端逻辑保持一致。

优势总结 #

• 减少重复代码：新增/删除筛选参数仅需修改FilterViewModel，无需批量修改前端代码
• 避免参数丢失：所有筛选参数自动携带，无需担心漏写路由属性
• 代码更整洁：页面模型与前端代码结构更清晰，便于维护

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