ASP.NET Core Razor Pages绑定分部视图到页面模型报错

触发这个异常是两个核心设计错误：

1. 错误为分部视图创建了继承自PageModel的模型类。PageModel是Razor 页面的专属基类，和HttpContext、请求生命周期强绑定，框架执行模型绑定时会尝试初始化它依赖的请求上下文对象，但分部视图的渲染、绑定流程中不会自动注入这些上下文，必然出现实例化失败。
2. 主页面模型中给SearchModel属性标注了[BindProperty]，表单回发时模型绑定器会尝试通过无参构造创建_PartialPageModel实例再赋值属性，而继承自PageModel的类型本身就无法在脱离页面请求上下文的情况下通过无参构造正常初始化，直接触发绑定异常。

第一步：重构分部视图模型，移除PageModel继承 #

分部视图的模型使用普通POCO类即可，不要继承任何Razor页面专属基类，只保留需要渲染、绑定的属性：

// 分部视图使用的普通ViewModel，禁止继承PageModel
public class PersonSearchViewModel
{
    public int SelectedPersonId { get; set; }
    public List<SelectListItem> SearchValues { get; set; } = new();
}

第二步：在主页面PageModel中处理依赖注入与数据初始化 #

仓储等服务依赖只保留在主页面的PageModel中，分部视图需要的下拉数据由主页面在请求处理方法中填充，不要在分部视图模型中注入仓储：

public class RazorPageModel : PageModel
{
    private readonly IRepository _repository;

    public RazorPageModel(IRepository repository)
    {
        _repository = repository;
    }

    // 标注BindProperty支持回发时自动绑定分部视图提交的值
    [BindProperty]
    public PersonSearchViewModel SearchModel { get; set; } = new();

    public void OnGet()
    {
        // 主页面负责加载分部视图需要的下拉选项数据
        SearchModel.SearchValues = _repository.GetAllPersons()
            .Select(p => new SelectListItem
            {
                Text = p.Name,
                Value = p.Id.ToString()
            }).ToList();
    }

    public IActionResult OnPost()
    {
        // 回发后可直接获取用户选中的人员ID
        var selectedPersonId = SearchModel.SelectedPersonId;
        // 编写后续业务逻辑
        return Page();
    }
}

第三步：调整分部视图与主页面引用代码 #

1. 分部视图_PersonSearch.cshtml首行指定模型类型为普通ViewModel，不需要单独的代码后置PageModel文件：

   @model PersonSearchViewModel
   
   <div class="person-search-box">
       <label asp-for="SelectedPersonId">选择人员</label>
       <select asp-for="SelectedPersonId" asp-items="Model.SearchValues" class="form-control">
           <option value="">请选择人员</option>
       </select>
   </div>
   

2. 主页面中通过partial标签助手绑定分部视图即可，表单提交时值会自动绑定到主页面的SearchModel属性：

   <form method="post">
       <!-- 其他表单项 -->
       <partial name="_PersonSearch" for="SearchModel" />
       <button type="submit" class="btn btn-primary">提交</button>
   </form>
   

复用场景优化 #

如果这个人员搜索分部视图需要在多个页面使用，不想每个页面重复编写下拉数据加载逻辑，可以用View Component封装可复用逻辑，不要用带PageModel的分部视图：

• View Component原生支持依赖注入，可以直接注入IRepository加载数据，不会和主页面的模型绑定逻辑冲突
• 调用时仅需在页面写@await Component.InvokeAsync("PersonSearch")即可，回发时只要主页面存在对应ID属性或嵌套ViewModel属性，就能正常接收提交的值。

注意：Razor分部视图本身没有独立的请求生命周期，不要给分部视图创建独立的PageModel后置代码，和请求相关的依赖、数据加载逻辑要么由引用它的主页面提供，要么通过View Component封装复用。

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