Blazor中如何成功清除表单验证消息？

我有如下Blazor表单：

<EditForm Model="@Model" OnValidSubmit="@SubmitSuccess" OnInvalidSubmit="@SubmitFailure" Context="editContext">
    <DataAnnotationsValidator/> 
    //Here the controls
</EditForm>

表单中有一个必填属性，通过代码而非表单输入控件设置。我定义了属性：

private EditContext editContext;

并在OnParametersSet()中执行：

editContext = new EditContext(Model);

使用自定义数据注解验证时，验证消息显示正常，但尝试通过以下两种方法清除验证消息均无效：

1. 重新创建EditContext：

editContext = new EditContext(Model);
await InvokeAsync(StateHasChanged);

2. 通知属性变更：

editContext.NotifyFieldChanged("Property");
await InvokeAsync(StateHasChanged);

核心问题分析 #

你手动创建的EditContext实例和<EditForm>内部实际使用的实例不是同一个，因此操作自己创建的实例无法影响表单的验证状态。另外，NotifyFieldChanged需要传入FieldIdentifier对象而非字符串，否则无法正确定位字段。

正确实现步骤 #

1. 获取<EditForm>实际使用的EditContext

不要手动创建EditContext，而是通过组件引用获取表单内置的实例：

<EditForm @ref="editFormRef" Model="@Model" OnValidSubmit="@SubmitSuccess" OnInvalidSubmit="@SubmitFailure">
    <DataAnnotationsValidator/>
    <!-- 表单控件 -->
</EditForm>

@code {
    private EditForm? editFormRef;
    private EditContext? editContext;

    protected override void OnAfterRender(bool firstRender)
    {
        if (firstRender)
        {
            // 获取表单实际使用的EditContext
            editContext = editFormRef?.EditContext;
        }
    }
}

2. 清除验证消息的两种有效方法

方法一：清除指定字段或全部验证消息

直接调用EditContext的ClearValidationMessages方法：

private async Task ClearValidationMessages()
{
    if (editContext == null) return;

    // 清除单个字段的验证消息
    var fieldId = FieldIdentifier.Create(() => Model.Property);
    editContext.ClearValidationMessages(fieldId);

    // 或者清除所有字段的验证消息
    // editContext.ClearValidationMessages();

    await InvokeAsync(StateHasChanged);
}

方法二：更新字段值后触发重新验证

如果是因为字段值已通过代码修正，需要自动清除验证消息，可以更新值后触发字段变更通知并手动验证：

private async Task UpdatePropertyAndClearValidation()
{
    // 代码设置属性值
    Model.Property = "符合要求的新值";

    if (editContext == null) return;

    var fieldId = FieldIdentifier.Create(() => Model.Property);
    // 通知字段值变更
    editContext.NotifyFieldChanged(fieldId);
    // 手动触发该字段的验证（验证通过后消息自动清除）
    await editContext.ValidateAsync();

    await InvokeAsync(StateHasChanged);
}

关键注意事项 #

• 始终使用<EditForm>内置的EditContext实例，不要自行创建，避免实例不匹配。
• FieldIdentifier是Blazor定位字段的标准方式，必须通过FieldIdentifier.Create(() => Model.Property)生成，不能直接传字符串。
• 调用验证或清除方法后，需要调用StateHasChanged()触发UI更新。

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