ASP.NET Core 3.1多表单页面如何仅在对应表单显示错误？

这个问题在多表单的Razor Pages应用里很常见——默认的验证摘要会把所有ModelState错误都显示出来，不管是哪个表单提交的。既然你不想用字段绑定的方案，我给你几个实用的解决思路：

方法1：为每个表单分配唯一的错误键（推荐） #

核心思路是给不同表单的全局错误设置专属的键，这样就能在视图中精准控制哪个表单显示哪个错误。

后端代码调整 #

添加错误时，用表单专属的键代替空字符串：

public async Task<IActionResult> OnPostChangeEmailAsync([FromService] UserManager<User> userManager)
{
    // ... 省略业务逻辑
    // 用ChangeEmailForm作为该表单错误的专属键
    ModelState.AddModelError("ChangeEmailForm", "User not found or deleted");
    return Page();
}

视图代码调整 #

在对应表单中，手动检查这个专属键的错误并显示，字段级错误仍用asp-validation-for正常显示：

<div>
    <form method="post">
        <!-- 只显示ChangeEmail表单的全局错误 -->
        @if (ModelState.ContainsKey("ChangeEmailForm") && ModelState["ChangeEmailForm"].Errors.Any())
        {
            <div class="text-danger">
                @ModelState["ChangeEmailForm"].Errors.First().ErrorMessage
            </div>
        }
        
        <div class="form-group">
            <label asp-for="ChangeEmail"></label>
            <input asp-for="ChangeEmail" class="form-control" />
            <!-- 字段级错误正常显示 -->
            <span asp-validation-for="ChangeEmail" class="text-danger"></span>
        </div>
        
        <button type="submit" class="btn btn-primary" asp-page-handler="ChangeEmail">Change email</button>
    </form>
</div>

同理，修改ChangePassword表单的错误键为ChangePasswordForm，就能实现两个表单的错误完全隔离。

方法2：用ViewData标记错误来源表单 #

如果不想修改错误键的命名规则，可以用ViewData传递当前错误所属的表单标识，在视图中根据标识控制验证摘要的显示。

后端代码调整 #

提交错误时，用ViewData记录错误所属的表单：

public async Task<IActionResult> OnPostChangeEmailAsync([FromService] UserManager<User> userManager)
{
    // ... 省略业务逻辑
    ModelState.AddModelError("", "User not found or deleted");
    // 标记错误来自ChangeEmail表单
    ViewData["ErrorSourceForm"] = "ChangeEmail";
    return Page();
}

视图代码调整 #

在每个表单的验证摘要前添加判断，只显示对应来源的错误：

<div>
    <form method="post">
        <!-- 只有当错误来自ChangePassword表单时，才显示验证摘要 -->
        @if (ViewData["ErrorSourceForm"] as string == "ChangePassword")
        {
            <div class="validation-summary-valid text-danger" asp-validation-summary="All"></div>
        }
        
        <div class="form-group">
            <label asp-for="OldPassword"></label>
            <input asp-for="OldPassword" class="form-control" />
            <span asp-validation-for="OldPassword" class="text-danger"></span>
        </div>
        <!-- 其他密码字段 -->
        <button type="submit" class="btn btn-primary" asp-page-handler="ChangePassword">Change password</button>
    </form>
</div>

<div>
    <form method="post">
        <!-- 只有当错误来自ChangeEmail表单时，才显示验证摘要 -->
        @if (ViewData["ErrorSourceForm"] as string == "ChangeEmail")
        {
            <div class="validation-summary-valid text-danger" asp-validation-summary="All"></div>
        }
        
        <div class="form-group">
            <label asp-for="ChangeEmail"></label>
            <input asp-for="ChangeEmail" class="form-control" />
            <span asp-validation-for="ChangeEmail" class="text-danger"></span>
        </div>
        
        <button type="submit" class="btn btn-primary" asp-page-handler="ChangeEmail">Change email</button>
    </form>
</div>

这个方法的好处是不需要修改原有的错误添加逻辑，但要注意：如果某个表单同时有全局错误和字段级错误，字段级错误会正常显示，不会被隐藏。

总结 #

如果追求最清晰的错误隔离，**方法1（专属错误键）**是最优选择，它逻辑直观，不需要额外的状态标记。方法2适合不想改动错误添加逻辑的场景，灵活度也不错。两种方案都不需要修改字段绑定，完全符合你的需求。

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