Blazor EditForm 组件使用教程-C#.Net教程-PHP中文网

Blazor EditForm 组件使用教程

煙雲

发布： 2025-12-16 10:07:02

原创

462人浏览过

EditForm 是 Blazor 表单核心组件，需绑定模型并用 Data Annotations 实现验证；提供 OnValidSubmit 和 OnInvalidSubmit 事件分别处理通过与失败场景；支持自定义验证器及避免常见陷阱如手动赋值未通知上下文。

blazor editform 组件使用教程

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 自动校验整个模型。

芦笋演示

一键出成片的录屏演示软件，专为制作产品演示、教学课程和使用教程而设计。

237

查看详情

自定义验证器（非 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() 并手动清空字段