ASP.NET 4.8迁移至Core 6时IHtmlHelper扩展方法调用报错求助

在将ASP.NET 4.8项目迁移到ASP.NET Core 6时，自定义的HelpButton和FormLabelFor HtmlHelper扩展方法在Razor视图中调用时，出现IHtmlHelper<Model> does not contain a definition for <Foo>错误，可通过以下步骤解决：

1. 确保命名空间被正确引入 #

扩展方法所在的命名空间必须被Razor视图识别：

• 在单个视图顶部添加@using 你的扩展方法所在命名空间，比如扩展类在YourApp.Web.Extensions下，就加@using YourApp.Web.Extensions；
• 或者在项目根目录的_ViewImports.cshtml中添加该命名空间，实现全局引用，所有视图无需单独引入。

2. 适配ASP.NET Core的IHtmlHelper接口 #

ASP.NET Core中，视图中的@Html是IHtmlHelper<TModel>类型，而非ASP.NET 4.x中的HtmlHelper<TModel>类，需要修改扩展方法的第一个参数类型：

修正HelpButton方法 #

public static IHtmlContent HelpButton(this IHtmlHelper htmlHelper, Enums.ButtonSize buttonSize = Enums.ButtonSize.Normal)
{
    var button = new TagBuilder("button");

    button.MergeAttribute("type", "button");
    button.MergeAttribute("aria-label", "Help Button");
    button.MergeAttribute("tabindex", "100");

    button.AddCssClass("btn");
    button.AddCssClass("btn-outline-info");
    button.AddCssClass("btn-light");
    button.AddCssClass("help-button");

    if (buttonSize == Enums.ButtonSize.Small)
        button.AddCssClass("btn-sm");
    else if (buttonSize == Enums.ButtonSize.Large)
        button.AddCssClass("btn-lg");

    return BuildButton("Help", BuildInternalIconTag("fa-question-circle"), button);
}

修正FormLabelFor方法 #

public static IHtmlContent FormLabelFor<TModel, TValue>(this IHtmlHelper<TModel> htmlHelper, Expression<Func<TModel, TValue>> expression, object htmlAttributes = null)
{
    return FormLabelFor(htmlHelper, expression, null, htmlAttributes);
}

private static IHtmlContent FormLabelFor<TModel, TValue>(this IHtmlHelper<TModel> htmlHelper, Expression<Func<TModel, TValue>> expression, string labelText, object htmlAttributes)
{
    var attributes = HtmlHelper.AnonymousObjectToHtmlAttributes(htmlAttributes);

    if (attributes.ContainsKey("class"))
        attributes["class"] = $"{attributes["class"]} col-form-label";
    else
        attributes.Add("class", "col-form-label");

    var modelExpressionProvider = htmlHelper.ViewContext?.HttpContext?.RequestServices?.GetService<ModelExpressionProvider>()
        ?? new ModelExpressionProvider(htmlHelper.MetadataProvider);

    var modelExpression = modelExpressionProvider.CreateModelExpression(htmlHelper.ViewData, expression);

    if (!modelExpression.Metadata.IsRequired)
        return htmlHelper.LabelFor(expression, labelText, attributes);

    if (attributes.ContainsKey("class"))
        attributes["class"] = $"{attributes["class"]} required";
    else
        attributes.Add("class", "required");

    return htmlHelper.LabelFor(expression, labelText, attributes);
}

3. 清理并重建解决方案 #

• 清理项目缓存：右键解决方案 → 清理解决方案；
• 重新编译整个解决方案：右键解决方案 → 生成解决方案，确保扩展方法所在项目无编译错误，且Web项目已正确引用该项目。

4. 修正视图中的调用语法（针对FormLabelFor） #

视图中@Html.FormLabelFor(m => model)存在语法错误，需改为针对视图模型的属性引用，比如当前视图模型为YourViewModel，且包含UserName属性，应写成：

@Html.FormLabelFor(m => m.UserName)

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