FluentValidation 中扩展 WithState 方法支持访问 ValidationContext

在 FluentValidation 这个流行的.NET验证库中，开发者们经常需要自定义验证错误消息的状态信息。最近社区提出了一个关于扩展 WithState 方法的有价值建议，使其能够访问完整的 ValidationContext 对象。

现有功能分析

FluentValidation 目前提供的 WithState 方法允许开发者为验证规则添加自定义状态信息。这个方法有两个主要重载：

1. 接收一个静态对象
2. 接收一个接收模型实例和属性值的委托

然而，在某些高级场景中，开发者需要访问完整的 ValidationContext 对象来获取更多上下文信息。例如，当使用自定义的 ValidationContext 子类时，可能需要访问其中定义的特殊属性。

技术实现方案

社区贡献者 ChThy 提出了一个优雅的解决方案：为 WithState 方法添加一个新的重载，接收一个包含 ValidationContext 参数的委托。这个实现非常简洁：

public static IRuleBuilderOptions<T, TProperty> WithState<T, TProperty>(
    this IRuleBuilderOptions<T, TProperty> rule, 
    Func<T, TProperty, ValidationContext<T>, object> stateProvider) 
{
    stateProvider.Guard("A lambda expression must be passed to WithState", nameof(stateProvider));

    var wrapper = new Func<ValidationContext<T>, TProperty, object>((ctx, val) => {
        return stateProvider(ctx.InstanceToValidate, val, ctx);
    });

    Configurable(rule).Current.CustomStateProvider = wrapper;
    return rule;
}

这个实现保持了 FluentValidation 一贯的流畅接口设计风格，同时扩展了功能边界。

应用场景

这个增强功能特别适用于以下场景：

1. 当验证逻辑需要访问 ValidationContext 中的自定义属性时
2. 需要基于验证上下文动态生成状态信息的复杂业务规则
3. 实现上下文感知的自定义验证逻辑

技术价值

这个改进虽然看似简单，但实际上为 FluentValidation 带来了更强大的灵活性。它使得：

1. 验证逻辑可以获取更丰富的上下文信息
2. 开发者可以创建更智能、上下文感知的验证规则
3. 自定义验证状态可以基于更全面的信息来构建

总结

这个对 WithState 方法的扩展是 FluentValidation 功能演进的一个自然步骤，它填补了现有API的一个小空白，为高级使用场景提供了更好的支持。这种类型的渐进式改进正是使 FluentValidation 保持其作为.NET生态系统中首选验证库地位的原因之一。

该改进已经通过社区贡献的方式实现，并将在未来的版本中提供给所有用户，展示了开源社区协作的力量。