ASP.NET Core Razor Pages同一页面多处理程序验证冲突解决方法

针对同一个页面里登录、注册两个表单的服务器端验证冲突问题，有以下几种实用解决办法：

方法一：移除ModelState中无关字段的验证状态 #

在每个Post处理方法里，把另一个模型的所有字段从ModelState中移除，这样验证只会针对当前表单对应的模型：

public async Task<IActionResult> OnPostLogin()
{
    // 移除注册模型所有字段的验证状态
    foreach (var key in ModelState.Keys.Where(k => k.StartsWith("RegisterModel.")))
    {
        ModelState.Remove(key);
    }

    if (ModelState.IsValid)
    {
        // 执行登录逻辑
        return RedirectToPage("/Index");
    }
    // 验证失败返回页面
    return Page();
}

public async Task<IActionResult> OnPostRegister()
{
    // 移除登录模型所有字段的验证状态
    foreach (var key in ModelState.Keys.Where(k => k.StartsWith("LoginModel.")))
    {
        ModelState.Remove(key);
    }

    if (ModelState.IsValid)
    {
        // 执行注册逻辑
        return RedirectToPage("/Index");
    }
    // 验证失败返回页面
    return Page();
}

方法二：为表单绑定指定前缀，实现独立模型绑定 #

给每个表单的输入字段指定专属前缀，然后在处理方法里用[Bind(Prefix)]指定只绑定对应前缀的字段，这样另一个表单的字段不会被绑定到模型，自然不会触发验证：

页面表单代码（示例）： #

<!-- 登录表单 -->
<form method="post" asp-page-handler="Login">
    <input asp-for="LoginModel.UserName" />
    <span asp-validation-for="LoginModel.UserName"></span>
    <input asp-for="LoginModel.Password" />
    <span asp-validation-for="LoginModel.Password"></span>
    <button type="submit">登录</button>
</form>

<!-- 注册表单 -->
<form method="post" asp-page-handler="Register">
    <input asp-for="RegisterModel.Email" />
    <span asp-validation-for="RegisterModel.Email"></span>
    <input asp-for="RegisterModel.Password" />
    <span asp-validation-for="RegisterModel.Password"></span>
    <button type="submit">注册</button>
</form>

后台处理方法代码： #

public async Task<IActionResult> OnPostLogin([Bind(Prefix = "LoginModel")]LoginModel loginModel)
{
    if (ModelState.IsValid)
    {
        // 执行登录逻辑
        return RedirectToPage("/Index");
    }
    // 把绑定后的模型赋值回页面属性，保证错误信息回显
    LoginModel = loginModel;
    return Page();
}

public async Task<IActionResult> OnPostRegister([Bind(Prefix = "RegisterModel")]RegisterModel registerModel)
{
    if (ModelState.IsValid)
    {
        // 执行注册逻辑
        return RedirectToPage("/Index");
    }
    // 把绑定后的模型赋值回页面属性，保证错误信息回显
    RegisterModel = registerModel;
    return Page();
}

方法三：手动验证当前模型，跳过全局ModelState检查 #

使用Validator.TryValidateObject方法手动验证当前提交的模型，不依赖ModelState.IsValid的全局校验：

using System.ComponentModel.DataAnnotations;

public async Task<IActionResult> OnPostLogin()
{
    var validationContext = new ValidationContext(LoginModel, null, null);
    var validationResults = new List<ValidationResult>();
    
    if (Validator.TryValidateObject(LoginModel, validationContext, validationResults, validateAllProperties: true))
    {
        // 执行登录逻辑
        return RedirectToPage("/Index");
    }
    // 把验证错误添加到ModelState，用于页面回显错误信息
    foreach (var validationResult in validationResults)
    {
        ModelState.AddModelError($"LoginModel.{validationResult.MemberNames.First()}", validationResult.ErrorMessage);
    }
    return Page();
}

public async Task<IActionResult> OnPostRegister()
{
    var validationContext = new ValidationContext(RegisterModel, null, null);
    var validationResults = new List<ValidationResult>();
    
    if (Validator.TryValidateObject(RegisterModel, validationContext, validationResults, validateAllProperties: true))
    {
        // 执行注册逻辑
        return RedirectToPage("/Index");
    }
    // 把验证错误添加到ModelState，用于页面回显错误信息
    foreach (var validationResult in validationResults)
    {
        ModelState.AddModelError($"RegisterModel.{validationResult.MemberNames.First()}", validationResult.ErrorMessage);
    }
    return Page();
}

以上三种方法都能解决多表单验证冲突的问题，你可以根据自己的代码结构选择最适合的方式。

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