自定义TagHelper向AnchorTagHelper注入路由值失效问题求助

问题场景 #

在Razor Page应用中，自定义SortableTableHeaderTagHelper绑定到<a>标签，通过IHttpContextAccessor分析请求参数，自动添加asp-route-sortBy、asp-route-sortOrder等路由属性，期望AnchorTagHelper将这些属性转换为URL查询参数，但实际仅生成基础URL，查询参数未被正确附加。

自定义TagHelper代码：

[HtmlTargetElement("a", Attributes = "sort-by", ParentTag = "th")]
public class SortableTableHeaderTagHelper(IHttpContextAccessor httpContextAccessor) : TagHelper
{
    public override int Order => int.MinValue;

    [HtmlAttributeName("sort-by")]
    public string SortBy { get; set; } = default!;

    public override void Process(TagHelperContext context, TagHelperOutput output)
    {
        var request = httpContextAccessor.HttpContext!.Request;
        
        var currentSortBy = request.Query["sortBy"].ToString();
        var currentSortOrder = Enum.TryParse<SortDirection>(request.Query["sortOrder"].ToString(), out var sortOrderValue) ? sortOrderValue : SortDirection.Ascending;
        var currentQuery = request.Query["query"].ToString();

        var isAscending = currentSortOrder == SortDirection.Ascending;
        
        var sortOrder = currentSortBy == SortBy && isAscending ? SortDirection.Descending : SortDirection.Ascending;
        
        var iconClass = currentSortBy == SortBy ? (isAscending ? "fa-sort-up" : "fa-sort-down") : "fa-sort";
        
        output.Attributes.SetAttribute("asp-route-sortBy", SortBy);
        output.Attributes.SetAttribute("asp-route-sortOrder", sortOrder);
        
        if (!string.IsNullOrWhiteSpace(currentQuery))
        {
            output.Attributes.SetAttribute("asp-route-query", currentQuery);
        }

        output.PostContent.AppendHtml(
            $"""
            <i class='fa {iconClass}'></i>
            """);
    }
}

Razor使用代码：

<a asp-page="/Contacts/Index" sort-by="company">
    @Texts["TableHeaderCompany"]
</a>

实际渲染结果（查询参数缺失）：

<a asp-route-sortby="company" asp-route-sortorder="Ascending" href="/contacts">Company<i class="fa fa-sort"></i></a>

预期渲染结果：

<a href="/contacts?sortBy=company&amp;sortOrder=Ascending">Company<i class="fa fa-sort"></i></a>

问题原因 #

AnchorTagHelper执行时会一次性读取所有asp-*属性并生成href，后续添加的asp-route-*属性不会被重新解析，导致这些属性仅保留在HTML中，未转换为查询参数。

解决方案 #

放弃依赖AnchorTagHelper处理新增属性，改为直接使用IUrlHelper生成包含所有参数的完整URL，覆盖AnchorTagHelper生成的基础href。

修改后的TagHelper代码 #

[HtmlTargetElement("a", Attributes = "sort-by,asp-page", ParentTag = "th")]
public class SortableTableHeaderTagHelper(
    IHttpContextAccessor httpContextAccessor,
    IUrlHelperFactory urlHelperFactory,
    IActionContextAccessor actionContextAccessor) : TagHelper
{
    // 设置为int.MaxValue，确保在AnchorTagHelper之后执行，覆盖其生成的href
    public override int Order => int.MaxValue;

    [HtmlAttributeName("sort-by")]
    public string SortBy { get; set; } = default!;

    // 捕获原asp-page属性值
    [HtmlAttributeName("asp-page")]
    public string AspPage { get; set; } = default!;

    public override void Process(TagHelperContext context, TagHelperOutput output)
    {
        var request = httpContextAccessor.HttpContext!.Request;
        
        var currentSortBy = request.Query["sortBy"].ToString();
        var currentSortOrder = Enum.TryParse<SortDirection>(request.Query["sortOrder"].ToString(), out var sortOrderValue) ? sortOrderValue : SortDirection.Ascending;
        var currentQuery = request.Query["query"].ToString();

        var isAscending = currentSortOrder == SortDirection.Ascending;
        var sortOrder = currentSortBy == SortBy && isAscending ? SortDirection.Descending : SortDirection.Ascending;
        var iconClass = currentSortBy == SortBy ? (isAscending ? "fa-sort-up" : "fa-sort-down") : "fa-sort";

        // 构建包含所有参数的路由字典
        var routeValues = new Dictionary<string, object?>
        {
            ["sortBy"] = SortBy,
            ["sortOrder"] = sortOrder
        };

        if (!string.IsNullOrWhiteSpace(currentQuery))
        {
            routeValues["query"] = currentQuery;
        }

        // 使用UrlHelper生成完整URL
        var urlHelper = urlHelperFactory.GetUrlHelper(actionContextAccessor.ActionContext!);
        var fullUrl = urlHelper.Page(AspPage, routeValues);

        // 设置最终href属性，覆盖AnchorTagHelper的结果
        output.Attributes.SetAttribute("href", fullUrl);

        // 移除未被AnchorTagHelper处理的asp-route属性（可选，清理HTML）
        output.Attributes.RemoveAll("asp-route-sortBy");
        output.Attributes.RemoveAll("asp-route-sortOrder");
        output.Attributes.RemoveAll("asp-route-query");

        output.PostContent.AppendHtml($"<i class='fa {iconClass}'></i>");
    }
}

补充配置 #

在Program.cs中注册IActionContextAccessor服务：

builder.Services.AddHttpContextAccessor();
builder.Services.AddActionContextAccessor(); // 新增此行

关键修改说明 #

1. 调整执行顺序：将Order设为int.MaxValue，确保自定义TagHelper在AnchorTagHelper之后执行，从而覆盖其生成的基础href。
2. 捕获asp-page值：新增AspPage属性获取原标签的asp-page参数，用于生成正确的页面URL。
3. 直接生成URL：使用IUrlHelper构建包含所有查询参数的完整URL，确保参数被正确附加。
4. 清理冗余属性：移除未被处理的asp-route-*属性，避免HTML中残留无效属性。

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