ASP.NET Core 6 MVC迁移：MvcHtmlString替换及空引用警告解决

一、HtmlString改写正确性验证 #

ASP.NET MVC 5中的MvcHtmlString和ASP.NET Core 6中的HtmlString（命名空间：Microsoft.AspNetCore.Html）作用完全一致——都是用于封装无需HTML编码的HTML内容。只要你的方法核心逻辑未改动，仅将返回类型从MvcHtmlString替换为HtmlString，并且正确构造HtmlString实例，改写就是完全正确的。

示例对比：

MVC 5原方法 #

public static MvcHtmlString BuildColoredIconTag(this HtmlHelper htmlHelper, string iconClass, string color)
{
    var tagBuilder = new TagBuilder("i");
    tagBuilder.AddCssClass(iconClass);
    tagBuilder.Attributes.Add("style", $"color: {color};");
    return MvcHtmlString.Create(tagBuilder.ToString(TagRenderMode.Normal));
}

Core 6改写后方法 #

using Microsoft.AspNetCore.Html;
using Microsoft.AspNetCore.Mvc.Rendering;

public static HtmlString BuildColoredIconTag(this IHtmlHelper htmlHelper, string iconClass, string color)
{
    // 新增参数空值防护，避免内部空引用
    iconClass = iconClass ?? string.Empty;
    color = color ?? "#000";
    
    var tagBuilder = new TagBuilder("i");
    tagBuilder.AddCssClass(iconClass);
    tagBuilder.Attributes.Add("style", $"color: {color};");
    return new HtmlString(tagBuilder.ToString(TagRenderMode.Normal));
}

注意：Core中需将扩展方法的目标类型从HtmlHelper改为IHtmlHelper，确保适配Core的视图上下文。

二、分部视图空引用警告修复 #

空引用警告通常源于调用方法时的依赖对象（如IHtmlHelper实例、视图模型）可能为null，可按以下步骤逐一排查：

1. 确保扩展方法被正确引用
   在项目的_ViewImports.cshtml中添加扩展方法所在的命名空间，确保分部视图能识别该方法：

   @using YourProjectNamespace.HtmlExtensions
   

2. 防护视图模型空引用
   如果方法是定义在视图模型中，调用前需确保模型不为null：

   @model YourViewModel
   
   @if (Model != null)
   {
       @Model.BuildColoredIconTag("fas fa-user", "#ff0000")
   }
   // 或使用null合并运算符返回空内容
   @(Model?.BuildColoredIconTag("fas fa-user", "#ff0000") ?? HtmlString.Empty)
   

3. 抑制安全的空引用警告
   若你能确认调用时的对象绝对不为null（如视图的Html属性），可使用!运算符显式抑制警告：

   @Html.BuildColoredIconTag("fas fa-user", "#ff0000")!
   

4. 扩展方法内部空值检查
   在方法内部对所有输入参数添加空值校验，避免因参数null导致后续逻辑出错：

   public static HtmlString BuildColoredIconTag(this IHtmlHelper htmlHelper, string iconClass, string color)
   {
       if (htmlHelper == null) throw new ArgumentNullException(nameof(htmlHelper));
       iconClass = iconClass ?? throw new ArgumentNullException(nameof(iconClass));
       color = color ?? throw new ArgumentNullException(nameof(color));
       
       // 原有逻辑...
   }
   

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