ASP.NET Core MVC自定义Tag Helper：列表元素id与name设置实现

嘿，我刚好做过类似的需求！要让自定义Tag Helper像asp-for那样自动给列表元素加上带索引的name和id，核心是复用ASP.NET Core MVC内置的模型表达式处理工具，不用自己瞎拼字符串踩坑。

先搭好Tag Helper的基础结构 #

首先你得给自定义Tag Helper加一个类似asp-for的属性，同时注入框架的IHtmlGenerator和ViewContext——这俩是实现功能的关键：

[HtmlTargetElement("your-custom-tag", Attributes = ForAttributeName)]
public class CustomListAwareTagHelper : TagHelper
{
    private const string ForAttributeName = "asp-custom-for"; // 自定义的绑定属性名
    private readonly IHtmlGenerator _htmlGenerator;

    // 接收模型表达式，和asp-for的用法一致
    [HtmlAttributeName(ForAttributeName)]
    public ModelExpression For { get; set; }

    // 注入ViewContext，用来获取当前的字段前缀
    [ViewContext]
    [HtmlAttributeNotBound]
    public ViewContext ViewContext { get; set; }

    public CustomListAwareTagHelper(IHtmlGenerator htmlGenerator)
    {
        _htmlGenerator = htmlGenerator;
    }
}

核心逻辑：生成规范的name和id #

在Process方法里，借助框架的工具来生成符合模型绑定要求的属性值，比自己拼接靠谱多了：

public override void Process(TagHelperContext context, TagHelperOutput output)
{
    base.Process(context, output);

    if (For == null)
        return;

    // 生成完整的字段名称，比如Items[0].UserName，自动继承父级前缀
    var fullFieldName = _htmlGenerator.GetFullHtmlFieldName(ViewContext, For.Name);
    // 生成安全的ID，把[0]转换成_0__这种格式，避免浏览器识别问题
    var sanitizedId = TagHelperUtilities.CreateSanitizedId(fullFieldName, "-");

    // 给元素设置name和id属性
    output.Attributes.SetAttribute("name", fullFieldName);
    output.Attributes.SetAttribute("id", sanitizedId);

    // 要是需要绑定当前模型值，直接从For.Model里取就行
    if (For.Model != null)
    {
        output.Attributes.SetAttribute("value", For.Model.ToString());
    }
}

视图里怎么用？和asp-for一模一样 #

当你循环列表的时候，直接像用asp-for那样写就行：

@model YourViewModel
@for (int i = 0; i < Model.ProductList.Count; i++)
{
    <your-custom-tag asp-custom-for="ProductList[i].ProductName"></your-custom-tag>
}

这时候生成的元素就会自动带上name="ProductList[0].ProductName"和id="ProductList_0__ProductName"，完全适配模型绑定，提交表单的时候后端能直接接收到列表数据。

为啥要这么做？ #

自己拼接字符串很容易出错，比如索引格式不对、父级前缀没继承（比如在编辑器模板里），而用框架内置的IHtmlGenerator和ModelExpression，能完美复用ASP.NET Core的模型绑定逻辑，和asp-for的行为完全一致，省心又靠谱！

内容的提问来源于stack exchange，提问作者José Silva