WPF中的数据验证

2021-02-13 21:15

阅读:526

WPF的Binding使得数据能够在数据源和目标之间流通,在数据流通的中间,便能够对数据做一些处理。
数据转换数据验证便是在数据从源到目标 or 从目标到源 的时候对数据的验证和转换。
技术分享图片

ValidationRule 验证规则

WPF中提供了一个抽象类ValidationRule,我们自定义的验证规则都需要继承它,然后实现它的抽象
方法Validate,该方法需要返回一个ValidationResult对象来表示验证结果。举个例子,一个验证数字
的规则(输入的只能是数字)

public class NumberValidationRule : ValidationRule
    {
        public override ValidationResult Validate(object value, CultureInfo cultureInfo)
        {
            if (Regex.IsMatch(value.ToString(), "^[0-9]+$"))
            {
                return new ValidationResult(true, null);
            }
            else
            {
                return new ValidationResult(false, "请输入数字");
            }
        }
    }

其中ValidationRule的两个属性

  • ValidatesOnTargetUpdated

    该属性可以确定验证的方向,如果设置为false,那么只验证从目标到源的方向,如果为True,
    那么同时也会验证从源到目标的方向

  • ValidationStep
    该属性确定了验证的时机,它是一个枚举值
    1 CommittedValue,该值提交到数据源后,运行ValidationRule,即不管验证是否能通过,属性都会被更新
    2 ConvertedProposedValue,在进行了转换之后,运行ValidationRule,如果有数据转换,那么先转换再验证
    3 RawProposedValue,在任何转换发生之前,运行ValidationRule
    4 UpdatedValue,在更新了源后,运行ValidationRule,即属性值被更改之后,就会去验证,注意需要
    ValidatesOnTargetUpdated设置为True

还需要注意的是Binding对验证结果的处理,NotifyOnValidationError设置为True,即当发生验证
错误时,错误信息会从目标沿着可视树往上冒泡,直到该冒泡事件被侦听到并被处理。

   TextBox Grid.Row="1">
            TextBox.Text>
                Binding Path="Number" UpdateSourceTrigger="PropertyChanged" Converter="{StaticResource Converter}" NotifyOnValidationError="True">
                    Binding.ValidationRules>
                        validationRules:NumberValidationRule ValidatesOnTargetUpdated="True" ValidationStep="CommittedValue">validationRules:NumberValidationRule>
                    Binding.ValidationRules>
                Binding>
            TextBox.Text>
        TextBox>

当出现验证错误时,TextBox就会有一个红色的框,这是默认的错误模板样式,我们如何定义一个错误模板(ErrorTemplate)呢

错误模板 ErrorTemplate

   ControlTemplate x:Key="ErrorTemplate">
            StackPanel Orientation="Horizontal">
                AdornedElementPlaceholder x:Name="Placeholder">AdornedElementPlaceholder>
                TextBlock Foreground="Red" Text="{Binding ElementName=Placeholder,Path=AdornedElement.(Validation.Errors)[0].ErrorContent}" FontSize="20" x:Name="txt">TextBlock>
            StackPanel>
        ControlTemplate>
  TextBox Grid.Row="1" Height="30" Width="100" Validation.ErrorTemplate="{StaticResource ErrorTemplate}">

AdornedElementPlaceholder表示一个占位符,这里表示具体的控件即TextBox,这里表示错误模板的布局是
如果有验证错误,那么在TextBox的后边会有一个TextBlock文本,文本的内容显示的是验证错误的信息。

Validation

这里涉及到了一个类Validation,它是一个静态类,它的使用大多以附加属性出现。它的主要功能是
1 设置ErrorTemplate
2 判断是否有错误(HasError),以及获取错误列表(Errors)
3 侦听验证错误事件

前两点前面都有提到,现在来看下 侦听验证错误冒泡事件

Grid Grid.Row="1" Validation.Error="Validation_OnError">
            TextBox Height="30" Width="100" Validation.ErrorTemplate="{StaticResource ErrorTemplate}">
                TextBox.Text>
                    Binding Path="Number" UpdateSourceTrigger="PropertyChanged" NotifyOnValidationError="True">
                        Binding.ValidationRules>
                            validationRules:NumberValidationRule>validationRules:NumberValidationRule>
                        Binding.ValidationRules>
                    Binding>
                TextBox.Text>
            TextBox>
        Grid>

 private void Validation_OnError(object sender, ValidationErrorEventArgs e)
    {

        if (e.Action == ValidationErrorEventAction.Added)
        {
            //todo:新的验证错误
            _errorMessage = e.Error.ErrorContent.ToString();
        }
        else
        {
            //todo:清除原有错误
            _errorMessage = string.Empty;
        }
    }

这里需要注意的其实就是ValidationErrorEventAction这个枚举值,因为产生新的验证错误,和清除
原来的验证错误都会触发这个事件,所以需要区分开来对待。
至此,WPF中的数据验证差不多了。


评论


亲,登录后才可以留言!