Blazor 的
EditForm是处理表单提交与验证的核心组件，它把模型绑定、验证触发、提交逻辑封装得简洁又可控。用好它，关键不是堆代码，而是理清“模型—验证—事件”三者的协作关系。
绑定模型并启用基础验证
EditForm必须通过
Model参数绑定一个 C# 实体对象，Blazor 才能自动追踪字段变化、触发验证、映射输入控件值。推荐使用
[Required]、
[StringLength]等数据注解（Data Annotations），这是最轻量且内置支持的验证方式。
示例：
public class UserInput<br>{<br> [Required(ErrorMessage = "用户名不能为空")]<br> public string? Name { get; set; }<br><br> [EmailAddress(ErrorMessage = "邮箱格式不正确")]<br> public string? Email { get; set; }<br>}在 Razor 组件中绑定：
<EditForm Model="@userInput" OnValidSubmit="@HandleValidSubmit"><br> <InputText @bind-Value="userInput.Name" /><br> <ValidationMessage For="@(() => userInput.Name)" /><br> <InputEmail @bind-Value="userInput.Email" /><br> <ValidationMessage For="@(() => userInput.Email)" /><br> <button type="submit">提交</button><br></EditForm>
区分有效/无效提交的两种回调
EditForm提供两个独立事件： •
OnValidSubmit：仅当模型通过所有验证时触发，适合执行保存、跳转等主业务逻辑 •
OnInvalidSubmit：验证失败时触发，可用于埋点、聚焦首个错误字段或自定义提示
两者互斥，不会同时执行。不需要手动调用
Validate()—— 提交瞬间 Blazor 自动校验整个模型。
自定义验证器（非 Data Annotations 场景）
当需要跨字段验证（如“密码”和“确认密码”一致）、异步检查（如用户名是否已存在），或复用已有 FluentValidation 规则时，可实现
IValidator<t></t>接口或使用
DataAnnotationsValidator+ 自定义
ValidationAttribute。
更常见的是配合
ObjectGraphDataAnnotationsValidator（.NET 6+）支持嵌套对象验证，或直接在
OnValidSubmit中手动调用服务做二次校验（例如检查邮箱唯一性），失败时调用
editContext.NotifyValidationStateChanged()主动刷新 UI 错误状态。
避免常见陷阱
不要在OnValidSubmit中修改绑定的模型属性后立刻再次提交 —— 这会干扰 EditContext 的脏检查，可能跳过验证
InputText等内置输入组件依赖
@bind-Value，若改用
@onchange手动赋值，需同步调用
editContext.NotifyFieldChanged()验证消息显示依赖
ValidationMessage的
For表达式必须准确指向模型属性，不能写成
@(() => Name)（缺少实例上下文） 表单重置不是靠
new Model()就完事 —— 要重建
EditContext或调用
editContext.MarkAsUnmodified()并手动清空字段
基本上就这些。EditForm 不复杂，但容易忽略验证生命周期和上下文同步细节。把模型、验证规则、UI 绑定三者对齐，表单就能稳稳跑起来。
