MacOS下ASP.NET Core7 Razor页面asp-for及验证功能失效问题

核心问题 #

表单提交后credential.UserName和credential.Password始终为空、验证提示不生效的根本原因是模型绑定失败：ASP.NET Core Razor Pages默认不会自动将表单数据绑定到PageModel的公共属性上，必须显式标记[BindProperty]特性才能启用模型绑定。

修复步骤 #

1. 为PageModel的credential属性添加[BindProperty]特性 #

修改LoginModel类中的credential属性，添加[BindProperty]标记，让框架自动处理表单数据绑定：

namespace WebAppSecurity.Pages.Account
{
    public class LoginModel : PageModel
    {
        [BindProperty] // 添加此特性启用模型绑定
        public Credential credential { get; set; } = new Credential();

        public void OnGet()
        {
        }

        public async Task<IActionResult> OnPostAsync()
        {
            if (!ModelState.IsValid) 
                return Page();

            // 验证逻辑不变
            if(credential.UserName == "admin" && credential.Password == "admin")
            {
                var Claims = new List<Claim> 
                {
                    new Claim(ClaimTypes.Name,"admin"),
                    new Claim(ClaimTypes.Email, "admin@gmail.com")
                };
                var identity = new ClaimsIdentity(Claims, "MyCookieAuth");
                ClaimsPrincipal claimsprincipal = new ClaimsPrincipal(identity);

                await HttpContext.SignInAsync("MyCookieAuth", claimsprincipal);

                return RedirectToPage("/Index");
            }

            return Page();
        }
    }

    public class Credential
    {
        [Required]
        [Display(Name = "User Name")] // 修正Display属性，让label显示正确文本
        public string UserName { get; set; } = string.Empty;

        [Required]
        [DataType(DataType.Password)]
        public string Password { get; set; } = string.Empty;
    }
}

2. 确认Razor Pages基础配置完整 #

检查program.cs中是否包含Razor Pages的必要服务和中间件配置（默认模板会包含，但如果手动修改过可能缺失）：

// 添加Razor Pages服务
builder.Services.AddRazorPages();
// 保留你的认证服务配置
builder.Services.AddAuthentication().AddCookie("MyCookieAuth", options =>
{
    options.Cookie.Name = "MyCookieAuth";
    options.LoginPath = "/Account/Login";
});

var app = builder.Build();

// 中间件配置
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Error");
    app.UseHsts();
}

app.UseHttpsRedirection();
app.UseStaticFiles();

app.UseRouting();

// 启用认证和授权中间件
app.UseAuthentication();
app.UseAuthorization();

// 映射Razor Pages路由
app.MapRazorPages();

app.Run();

原理说明 #

• [BindProperty]特性告诉ASP.NET Core框架：该属性需要从请求（表单、查询字符串等）中绑定数据。没有这个标记，框架会忽略该属性，导致提交后属性值为空。
• 模型验证（[Required]等特性）只有在模型绑定成功后才会触发，绑定失败时ModelState.IsValid会返回true（因为没有绑定到模型，验证规则未被触发），所以验证提示不会显示。

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