Blazor自定义验证属性失效问题及修复方案

问题场景 #

• 为邮箱验证创建了继承自ValidationAttribute的自定义属性MailRegex，设置为始终返回验证失败结果
• 在Blazor的EditForm中提交表单时，OnValidSubmit确实未触发（绑定的Test属性未更新），但UI上完全看不到验证错误提示
• 将重写的ValidationResult? IsValid(object?, ValidationContext)方法替换为bool IsValid(object)后，验证错误提示正常显示，属性恢复正常工作

原因分析 #

Blazor的表单验证系统对ValidationAttribute的方法重载有特定处理逻辑：

• bool IsValid(object)是ValidationAttribute的基础同步验证方法，Blazor验证机制会直接识别该方法的返回值，并自动把ErrorMessage渲染到对应控件的错误提示区域
• 而ValidationResult? IsValid(object?, ValidationContext)虽为.NET Core引入的灵活重载，但Blazor在处理该方法时，未自动将返回的ValidationResult关联到表单控件的错误集合中，导致错误信息无法被UI渲染

解决方法 #

根据需求选择对应的重写方式：

方式1：重写bool IsValid(object)（无需上下文信息场景） #

这是Blazor验证系统优先识别的同步验证逻辑，能确保错误提示正常显示：

public class MailRegexAttribute : ValidationAttribute
{
    public override bool IsValid(object? value)
    {
        // 此处替换为实际验证逻辑，示例为始终返回失败
        ErrorMessage = "邮箱格式不符合要求";
        return false;
    }
}

方式2：需使用ValidationContext时的处理 #

如果需要获取属性名、容器对象等上下文信息，不要直接重写ValidationResult? IsValid(object?, ValidationContext)，而是重写Validate(object value, ValidationContext validationContext, ICollection<ValidationResult> results)方法，手动将错误结果添加到集合中：

public class MailRegexAttribute : ValidationAttribute
{
    protected override void Validate(object? value, ValidationContext validationContext, ICollection<ValidationResult> results)
    {
        // 此处替换为实际验证逻辑，示例为始终返回失败
        var errorMessage = FormatErrorMessage(validationContext.DisplayName);
        results.Add(new ValidationResult(errorMessage, new[] { validationContext.MemberName }));
    }
}

这种方式能确保Blazor验证系统正确收集错误信息，并渲染到对应表单控件的错误提示区域。

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