使用ASP.NET EditorFor处理抽象类型：单个属性模板匹配异常问题

问题现象 #

在ASP.NET应用中，当ViewModel的集合属性为抽象基类的泛型集合时，@Html.EditorFor(x => x.BaseTypeCollection)能自动识别集合中子类的实际类型，加载对应的编辑器模板；但单独取出集合中的某个元素（比如@Html.EditorFor(x => x.BaseTypeCollection.ToArray()[0])）时，EditorFor会按基类BaseType查找模板，无法自动匹配子类模板。手动指定模板名称可解决问题，但灵活性不足。

代码示例 #

基类与子类定义 #

// /models/basetype.cs
public abstract class BaseType {
    public int Id { get; set; }
    public string LabelText { get => nameof(this); }
}

// /models/inheritedtype1.cs
public class InheritedType1 : BaseType {
    public string Value { get; set; }
}

// /models/inheritedtype2.cs
public class InheritedType2 : BaseType {
    public decimal Value { get; set; }
}

编辑器模板 #

<!-- /views/shared/editortemplates/InheritedType1.cshtml -->
@model InheritedType1
<label asp-for="@Model.LabelText"></label>
<input asp-for="@Model.Value" class="form-control" />

<!-- /views/shared/editortemplates/InheritedType2.cshtml -->
@model InheritedType2
<label asp-for="@Model.LabelText"></label>
<input asp-for="@Model.Value" class="form-control" />

ViewModel与控制器 #

// /models/vm.cs
public class vm {
    public IEnumerable<BaseType> BaseTypeCollection { get;set; }
}

// /controllers/homecontroller.cs
public class HomeController : Controller {
    public readonly MyServiceType _service;
    public HomeController(MyServiceType service) => _service = service;
    public IActionResult Index() {
        var vm = new vm() { 
            BaseTypeCollection = _service.getBaseTypes() // 返回包含InheritedType1和InheritedType2的集合
        };
        return View(vm);
    }
}

视图中的差异表现 #

• 正常匹配子类模板：@Html.EditorFor(x => x.BaseTypeCollection)
• 无法自动匹配：@Html.EditorFor(x => x.BaseTypeCollection.ToArray()[0])
• 手动指定可行：@Html.EditorFor(x => x.BaseTypeCollection.ToArray()[0], "InheritedType2")

原因分析 #

EditorFor处理集合时，内部会遍历每个元素，通过反射获取元素的运行时类型来查找对应模板；但传递单个元素时，表达式x => x.BaseTypeCollection.ToArray()[0]的编译时静态类型是BaseType，EditorFor默认基于静态类型查找模板，而非元素的实际运行时类型。

解决方案 #

方案1：自定义HtmlHelper扩展方法 #

通过扩展方法手动获取元素的运行时类型，指定模板名称为类型名：

using Microsoft.AspNetCore.Mvc.Rendering;
using System;
using System.Linq.Expressions;

public static class HtmlHelperExtensions
{
    public static IHtmlContent EditorForRuntimeType<TModel, TValue>(this IHtmlHelper<TModel> htmlHelper, Expression<Func<TModel, TValue>> expression)
    {
        var model = htmlHelper.ViewData.Model;
        var value = expression.Compile().Invoke(model);
        if (value == null)
        {
            return htmlHelper.EditorFor(expression);
        }
        var runtimeType = value.GetType();
        return htmlHelper.EditorFor(expression, runtimeType.Name);
    }
}

视图中使用：

@Html.EditorForRuntimeType(x => x.BaseTypeCollection.ToArray()[0])

方案2：循环遍历手动指定模板 #

遍历集合时，直接获取元素的类型名称作为模板名：

@foreach (var item in Model.BaseTypeCollection)
{
    @Html.EditorFor(modelItem => item, item.GetType().Name)
}

方案3：基类模板转发（推荐） #

创建BaseType.cshtml模板，内部根据实际类型转发到子类模板：

<!-- /views/shared/editortemplates/BaseType.cshtml -->
@model BaseType

@if (Model is InheritedType1 type1)
{
    @Html.EditorFor(m => type1, "InheritedType1")
}
else if (Model is InheritedType2 type2)
{
    @Html.EditorFor(m => type2, "InheritedType2")
}
// 其他子类可继续扩展

这样即使调用@Html.EditorFor(x => x.BaseTypeCollection.ToArray()[0])，也会先进入BaseType模板，自动匹配到对应的子类模板。

总结 #

EditorFor对集合和单个元素的模板查找逻辑存在差异：集合遍历使用运行时类型，单个元素默认使用编译时静态类型。通过自定义扩展、手动指定模板名或基类模板转发，可解决单个元素无法自动匹配子类模板的问题。

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