Razor Pages能否使用ViewComponents？ASP.NET Core 2.0调用异常咨询

我之前也踩过这个一模一样的坑！这个错误的核心原因很明确：Razor Page的ViewData会默认传递给ViewComponent的视图，而你的页面本身绑定了一个指定类型的模型（也就是错误提示里的<parentpagetype>），但ViewComponent返回的是它自己的模型类型（<viewcomponenttype>），两者类型不匹配就触发了这个异常。

下面是两种最直接有效的解决办法：

方法一：调用ViewComponent时传递空的ViewDataDictionary #

在Razor Page里调用ViewComponent时，明确传入ViewDataDictionary.Empty，彻底切断页面ViewData的继承，自然就不会有模型类型冲突了。示例代码：

@await Component.InvokeAsync(nameof(YourTargetViewComponent), 
    new { /* 这里传入ViewComponent需要的参数 */ }, 
    ViewDataDictionary.Empty)

方法二：在ViewComponent的视图中明确隔离模型 #

如果你需要保留部分ViewData的值，不想完全清空，那可以在ViewComponent的.cshtml视图开头显式指定模型类型，并且确保视图里只使用@model来访问组件的模型，绝对不要用ViewData.Model。示例：

@model YourViewComponentModelType

<!-- 这里用@model访问组件的模型数据，比如： -->
<div>@model.ComponentSpecificProperty</div>

额外技巧：按需传递ViewData项 #

如果你的ViewComponent需要用到页面ViewData里的某些特定值，可以创建一个新的ViewDataDictionary，只传递需要的项，而不是把整个页面的ViewData传过去：

@await Component.InvokeAsync(nameof(YourTargetViewComponent), 
    new { /* 组件参数 */ }, 
    new ViewDataDictionary(ViewData) { { "RequiredKey", ViewData["RequiredKey"] } })

这样既满足了组件对ViewData的需求，又避免了页面模型类型的干扰。

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