EditForm 是 Blazor 表单核心组件，需绑定模型并用 Data Annotations 实现验证；提供 OnValidSubmit 和 OnInvalidSubmit 事件分别处理通过与失败场景；支持自定义验证器及避免常见陷阱如手动赋值未通知上下文。
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></inputtext><br><validationmessage for="@(() => userInput.Name)"></validationmessage><br><inputemail></inputemail><br><validationmessage for="@(() => userInput.Email)"></validationmessage><br><button type="submit">提交</button><br></editform>
区分有效/无效提交的两种回调
EditForm 提供两个独立事件：
• OnValidSubmit：仅当模型通过所有验证时触发，适合执行保存、跳转等主业务逻辑
• OnInvalidSubmit：验证失败时触发，可用于埋点、聚焦首个错误字段或自定义提示
两者互斥，不会同时执行。不需要手动调用 Validate() —— 提交瞬间 Blazor 自动校验整个模型。
自定义验证器（非 Data Annotations 场景）
当需要跨字段验证（如“密码”和“确认密码”一致）、异步检查（如用户名是否已存在），或复用已有 FluentValidation 规则时，可实现 IValidator 接口或使用 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 绑定三者对齐，表单就能稳稳跑起来。
