C# 如何在自定义TagHelper中渲染字符串形式的嵌套TagHelper

问题根因 #

你当前写法失败有两个核心原因：

1. 在Process方法中拼接的<icon>标签仅为普通字符串，ASP.NET Core的TagHelper解析仅在视图初次渲染的前置阶段执行，动态生成的标签不会被二次解析，因此无法触发IconTagHelper的处理逻辑。
2. 你使用了async void定义Process方法，这会导致异步逻辑执行顺序混乱、异常无法捕获，TagHelper异步逻辑需要重写ProcessAsync方法返回Task。

可行解决方案 #

方案1：直接生成Icon最终输出（最简实现）

如果明确IconTagHelper的最终渲染结构，直接拼接对应HTML即可，不需要绕二次调用TagHelper的逻辑：

[HtmlTargetElement("custom-button")]
public class CustomButtonTagHelper : TagHelper
{
    private readonly IFileVersionProvider _fileVersionProvider;

    [ViewContext]
    public ViewContext ViewContext { get; set; }
    
    public CustomButtonTagHelper(IFileVersionProvider fileVersionProvider)
    {
        _fileVersionProvider = fileVersionProvider;
    }

    [HtmlAttributeName("icon")]
    public string Icon { get; set; }

    // 替换为ProcessAsync返回Task
    public override async Task ProcessAsync(TagHelperContext context, TagHelperOutput output)
    {
        output.TagMode = TagMode.StartTagAndEndTag;
        output.TagName = "button";

        // 先获取按钮内部原有子内容（保留用户写的按钮文本等）
        var originalContent = await output.GetChildContentAsync();
        
        // 如果设置了icon属性，拼接icon的最终渲染HTML
        if (!string.IsNullOrEmpty(Icon))
        {
            // 此处替换为你实际IconTagHelper的输出结构即可，比如下面的示例
            output.Content.AppendHtml($"<i class=\"icon icon-{Icon}\"></i> ");
        }
        
        // 追加原有子内容
        output.Content.AppendHtml(originalContent);
    }
}

方案2：手动调用IconTagHelper复用逻辑

如果你不想硬编码Icon的输出结构，需要完全复用IconTagHelper的逻辑，可以手动实例化并执行它的渲染流程：

public override async Task ProcessAsync(TagHelperContext context, TagHelperOutput output)
{
    output.TagMode = TagMode.StartTagAndEndTag;
    output.TagName = "button";

    var originalContent = await output.GetChildContentAsync();
    
    if (!string.IsNullOrEmpty(Icon))
    {
        // 实例化IconTagHelper，构造参数如果需要从DI获取，可提前注入到CustomButtonTagHelper的构造函数中
        var iconTagHelper = new IconTagHelper(/* IconTagHelper需要的构造参数 */)
        {
            Name = Icon,
            ViewContext = this.ViewContext
        };
        
        // 创建IconTagHelper运行需要的上下文和输出对象
        var iconContext = new TagHelperContext(
            new TagHelperAttributeList(),
            new Dictionary<object, object>(),
            Guid.NewGuid().ToString("N"));
        var iconOutput = new TagHelperOutput(
            "icon",
            new TagHelperAttributeList(),
            (_, _) => Task.FromResult<TagHelperContent>(new DefaultTagHelperContent()));
        
        // 执行IconTagHelper的处理逻辑
        await iconTagHelper.ProcessAsync(iconContext, iconOutput);
        
        // 把渲染完成的icon内容加到按钮中
        output.Content.AppendHtml(iconOutput);
    }
    
    output.Content.AppendHtml(originalContent);
}

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