Blazorise中使用IValidatableObject实现动态表单验证

在Blazorise框架中，表单验证是一个核心功能，开发者经常需要根据业务逻辑实现动态验证规则。本文将介绍如何利用.NET的IValidatableObject接口在Blazorise中实现灵活的表单验证。

动态验证需求场景

在实际开发中，我们经常会遇到这样的需求：某些字段的验证规则需要根据其他字段的值动态变化。例如：

• 当订单状态为"已完成"时，必须填写完成备注
• 当用户选择"其他"选项时，必须填写附加说明
• 某些字段只在特定条件下才需要验证

IValidatableObject接口简介

IValidatableObject是.NET提供的一个接口，允许我们在模型类中实现自定义验证逻辑。它定义了一个Validate方法，我们可以在这个方法中编写任何复杂的验证规则。

实现示例

下面是一个在Blazorise中使用IValidatableObject的完整示例：

@using System.ComponentModel.DataAnnotations;

<Select @bind-SelectedValue=mydata.Status>
    <SelectItem>New</SelectItem>
    <SelectItem>Completed</SelectItem>
</Select>

<Validations @ref=valref1 Model=mydata Mode="ValidationMode.Manual">
    <Validation>
        <TextEdit @bind-Text=mydata.Text1></TextEdit>
    </Validation>
    <Validation>
        <TextEdit @bind-Text=mydata.Text2></TextEdit>
    </Validation>
</Validations>

<Button Background="Background.Primary" @onclick=Submit>Submit</Button>

@code {
    someData mydata = new();
    Validations valref1;

    async Task Submit()
    {
        valref1.ClearAll();
        await valref1.ValidateAll();
    }

    class someData : IValidatableObject
    {
        [Required]
        public string Text1 { get; set; }

        public string Text2 { get; set; }
        public string Status { get; set; } = "New";

        public IEnumerable<ValidationResult> Validate(ValidationContext validationContext)
        {
            if (Status == "Completed")
            {
                if (string.IsNullOrEmpty(Text2))
                {
                    yield return new ValidationResult("Text2 is required", new[] { nameof(Text2) });
                }
            }
        }
    }
}

代码解析

1. UI部分：

   • 使用Select组件绑定到Status属性
   • 使用Validations组件包裹两个TextEdit输入框
   • 设置验证模式为Manual，以便手动触发验证

2. 验证逻辑：

   • Text1使用标准的[Required]特性进行验证
   • Text2的验证规则在Validate方法中实现，只有当Status为"Completed"时才验证Text2是否为空

3. 提交处理：

   • 点击按钮时先清除所有验证状态
   • 然后手动触发全部验证

优势分析

1. 灵活性：可以编写任何复杂的条件验证逻辑
2. 集中管理：所有验证规则都集中在模型类中，便于维护
3. 与Blazorise无缝集成：不需要额外配置，直接使用框架提供的验证机制
4. 可重用性：验证逻辑与UI分离，可以在多个地方重用同一个模型

最佳实践建议

1. 对于简单的验证规则，优先使用数据注解特性(如[Required], [Range]等)
2. 对于复杂的条件验证，使用IValidatableObject接口
3. 在Validate方法中保持逻辑简洁，复杂的业务规则可以考虑提取到单独的服务类
4. 考虑使用FluentValidation等第三方库处理更复杂的验证场景

通过这种方式，开发者可以在Blazorise应用中实现灵活而强大的表单验证功能，满足各种业务场景的需求。