解决ASP.NET MVC向分部视图传ViewBag列表时的InvalidOperationException

错误根源 #

分部视图Index.cshtml声明要求的模型类型是List<EntityLayer.Concrete.Content>，但调用时传入的模型（或ViewData默认继承的父视图模型）是System.String类型，导致视图模型校验失败，触发InvalidOperationException。

针对性修复方案 #

1. 显式传递正确类型的模型 #

如果父视图Headings.cshtml的模型不是List<Content>，调用分部视图时必须手动传入符合要求的模型实例：

控制器层准备数据（DefaultController.cs）

public ActionResult Headings()
{
    // 从服务/数据库获取正确的Content列表
    List<Content> contentList = _contentRepository.GetAllContents();
    // 通过ViewBag传递给视图
    ViewBag.ContentData = contentList;
    return View();
}

视图层调用分部视图（Headings.cshtml）

<!-- 显式传入ViewBag中的列表数据，同时做类型转换确保安全 -->
@Html.Partial("Index", ViewBag.ContentData as List<EntityLayer.Concrete.Content>)

如果父视图本身的模型就是List<Content>，直接传递父模型即可：

@model List<EntityLayer.Concrete.Content>
<!-- 其他视图内容 -->
@Html.Partial("Index", Model)

2. 确认分部视图的模型声明（Index.cshtml） #

检查分部视图顶部的模型声明是否准确，避免类型拼写错误：

@model List<EntityLayer.Concrete.Content>

<!-- 分部视图渲染逻辑示例 -->
@foreach(var content in Model)
{
    <h3>@content.Title</h3>
    <p>@content.Summary</p>
}

3. 避免隐式继承父视图模型 #

如果父视图Headings.cshtml的模型是string类型，调用Html.Partial时如果省略第二个参数，会自动传递父视图的模型（即string），这是错误的核心原因。必须显式指定分部视图需要的模型，哪怕是空列表（new List<Content>()）。

4. Ajax加载分部视图的正确方式 #

如果用Ajax加载分部视图，确保控制器Action返回的是带正确模型的分部视图：

控制器新增Action（DefaultController.cs）

public ActionResult LoadIndexPartial()
{
    List<Content> contentList = _contentRepository.GetAllContents();
    // 返回分部视图并传入模型
    return PartialView("Index", contentList);
}

视图层Ajax调用（Headings.cshtml）

<div id="partial-content-container"></div>

<script>
$(function(){
    $.get('@Url.Action("LoadIndexPartial", "Default")', function(result){
        $('#partial-content-container').html(result);
    });
});
</script>

常见误区排查 #

• ViewBag是dynamic类型，传递复杂类型时必须显式转换为目标类型，避免类型推断错误；
• 调用分部视图时，若不需要传递模型，也不能省略第二个参数，需传入null或符合类型的空实例（比如new List<Content>()），防止自动继承父视图的不匹配模型。

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