Razor Pages锚点标签传递字符串数组查询参数问题

问题根源在于ASP.NET Core的asp-route-*标签助手无法直接处理集合（List/Array）类型的参数，它会默认调用集合的ToString()方法，导致URL中出现System.String[]这类无效值。以下是几种无需用分隔符拼接字符串的可行方案：

方法一：手动构建完整URL（最直接） #

在Razor视图中通过代码拼接包含所有筛选参数的查询字符串，手动处理集合类型的参数：

@{
    var queryParts = new List<string>();
    // 添加排序参数
    queryParts.Add($"sortField=VacationStatus");
    queryParts.Add($"isDescending={(Model.SortField == "VacationStatus" ? !Model.IsDescending : false)}");
    
    // 添加单值筛选参数
    if (!string.IsNullOrEmpty(Model.EmployeeName))
    {
        queryParts.Add($"EmployeeName={Uri.EscapeDataString(Model.EmployeeName)}");
    }
    if (!string.IsNullOrEmpty(Model.SelectedYear))
    {
        queryParts.Add($"SelectedYear={Uri.EscapeDataString(Model.SelectedYear)}");
    }
    if (!string.IsNullOrEmpty(Model.SelectedAccountingStatus))
    {
        queryParts.Add($"SelectedAccountingStatus={Uri.EscapeDataString(Model.SelectedAccountingStatus)}");
    }
    
    // 处理多选月份
    foreach (var month in Model.SelectedMonths)
    {
        queryParts.Add($"SelectedMonths={Uri.EscapeDataString(month)}");
    }
    // 处理多选状态
    foreach (var status in Model.SelectedStatuses)
    {
        queryParts.Add($"SelectedStatuses={Uri.EscapeDataString(status)}");
    }
    
    // 拼接完整URL
    var fullUrl = Url.Action("Index") + "?" + string.Join("&", queryParts);
}

<a href="@fullUrl">
    Staatus <i class="fa-solid fa-sort ms-2"></i>
</a>

方法二：使用RouteValueDictionary构建URL #

利用RouteValueDictionary自动处理参数编码，同时拆分集合参数：

@{
    var routeValues = new RouteValueDictionary
    {
        { "sortField", "VacationStatus" },
        { "isDescending", Model.SortField == "VacationStatus" ? !Model.IsDescending : false },
        { "EmployeeName", Model.EmployeeName },
        { "SelectedYear", Model.SelectedYear },
        { "SelectedAccountingStatus", Model.SelectedAccountingStatus }
    };

    // 拆分多选月份到路由字典
    foreach (var month in Model.SelectedMonths)
    {
        routeValues.Add("SelectedMonths", month);
    }
    // 拆分多选状态到路由字典
    foreach (var status in Model.SelectedStatuses)
    {
        routeValues.Add("SelectedStatuses", status);
    }

    var fullUrl = Url.Action("Index", routeValues);
}

<a href="@fullUrl">
    Staatus <i class="fa-solid fa-sort ms-2"></i>
</a>

方法三：自定义标签助手（复用性强） #

如果项目中多处需要处理集合参数，可以自定义一个扩展标签助手，自动处理集合类型的路由参数：

1. 创建自定义TagHelper类

using Microsoft.AspNetCore.Mvc.TagHelpers;
using Microsoft.AspNetCore.Mvc.ViewFeatures;
using Microsoft.AspNetCore.Razor.TagHelpers;
using System.Collections;

[HtmlTargetElement("a", Attributes = "asp-route-collections")]
public class CollectionAnchorTagHelper : AnchorTagHelper
{
    public CollectionAnchorTagHelper(IHtmlGenerator generator) : base(generator)
    {
    }

    [HtmlAttributeName("asp-route-collections")]
    public IDictionary<string, IEnumerable> RouteCollections { get; set; }

    public override void Process(TagHelperContext context, TagHelperOutput output)
    {
        if (RouteCollections != null)
        {
            foreach (var kvp in RouteCollections)
            {
                foreach (var item in kvp.Value)
                {
                    RouteValues.Add(kvp.Key, item);
                }
            }
        }
        base.Process(context, output);
    }
}

2. 在_ViewImports.cshtml中注册TagHelper

@addTagHelper *, YourProjectAssemblyName

3. 在视图中使用

<a asp-action="Index"
   asp-route-sortField="VacationStatus"
   asp-route-isDescending="@(Model.SortField == "VacationStatus" ? !Model.IsDescending : false)"
   asp-route-EmployeeName="@Model.EmployeeName"
   asp-route-SelectedYear="@Model.SelectedYear"
   asp-route-SelectedAccountingStatus="@Model.SelectedAccountingStatus"
   asp-route-collections='new Dictionary<string, IEnumerable> { 
       { "SelectedMonths", Model.SelectedMonths }, 
       { "SelectedStatuses", Model.SelectedStatuses } 
   }'>
    Staatus <i class="fa-solid fa-sort ms-2"></i>
</a>

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