ASP.NET Core 3.1 局部视图传入模型类型与预期不匹配报错求助

错误根本原因 #

1. 你使用<partial name="StatusName1" />标签渲染局部视图时，默认会将父视图的模型（此处Index.cshtml的模型为IEnumerable<Advertisement>）直接传递给局部视图，而局部视图声明需要的模型是Tip类型，类型不匹配直接触发报错。且这种写法不会调用你在HomeController中定义的StatusName1方法，仅会直接查找对应视图文件渲染，不会执行你写的查询逻辑。
2. 即使通过其他方式触发了StatusName1方法，该方法本身逻辑也不匹配：你将查询得到的Tip对象调用ToString()转为了字符串，返回值类型和局部视图要求的Tip类型仍然不一致。

解决方案（推荐用视图组件，更适配布局页公共模块场景） #

ASP.NET Core 推荐使用*视图组件（View Component）*实现布局页的公共渲染模块，替代旧版MVC的ChildAction方案。

步骤1：创建视图组件类 #

在项目根目录新建ViewComponents文件夹，新增StatusNameViewComponent.cs文件，代码如下：

using Microsoft.AspNetCore.Mvc;
using Microsoft.EntityFrameworkCore;
using RealEstateAspNetCore3._1.Models;
// 此处替换为你自己的DbContext命名空间
using YourProjectNamespace.Data;

public class StatusNameViewComponent : ViewComponent
{
    private readonly YourDbContext _context;
    // 构造函数注入DbContext
    public StatusNameViewComponent(YourDbContext context)
    {
        _context = context;
    }

    public async Task<IViewComponentResult> InvokeAsync()
    {
        // 注意Include加载Status导航属性，否则访问Model.Status会报空引用
        var tip = await _context.Tips
            .Include(t => t.Status)
            .FirstOrDefaultAsync(i => i.StatusId == 1);
        // 处理空值避免报错
        if (tip == null) return Content("");
        return View(tip);
    }
}

步骤2：创建视图组件对应的视图 #

在Views/Shared/目录下新建层级文件夹Components/StatusName，新增Default.cshtml视图文件，内容和你原来的StatusName1.cshtml一致：

@model RealEstateAspNetCore3._1.Models.Tip

<a href="#" class="dropdown-toggle" data-toggle="dropdown" role="button">
    @Model.Status.StatusName <span class="caret"></span>
</a>

步骤3：修改布局页的调用代码 #

把原来的<partial name="StatusName1" />替换为视图组件调用代码即可：

@await Component.InvokeAsync("StatusName")

如果要使用标签助手方式调用，可在_ViewImports.cshtml中注册你项目的视图组件命名空间，之后使用如下标签调用：

<vc:status-name></vc:status-name>

备选方案：沿用原有控制器方法实现 #

如果不想使用视图组件，要沿用你原来的控制器方法，可按如下修改：

步骤1：修正控制器方法逻辑 #

using Microsoft.EntityFrameworkCore;

public PartialViewResult StatusName1()
{
    var tip = _context.Tips
        .Include(t => t.Status)
        .FirstOrDefault(i => i.StatusId == 1);
    if (tip == null) return PartialView("StatusName1", new Tip());
    // 不要调用ToString，直接返回Tip对象
    return PartialView("StatusName1", tip);
}

步骤2：修改布局页调用方式 #

不要用<partial>标签，改为调用控制器Action的方式渲染：

@await Html.RenderActionAsync("StatusName1", "Home")

注意：ASP.NET Core 3.1默认未内置RenderActionAsync，需要先安装NuGet包Microsoft.AspNetCore.Mvc.ViewFeatures，并在Startup配置中启用对应支持。

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