WPF中的数据验证

Posted 山涧清泉

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了WPF中的数据验证相关的知识,希望对你有一定的参考价值。

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

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中的数据验证差不多了。

以上是关于WPF中的数据验证的主要内容,如果未能解决你的问题,请参考以下文章

强制验证 WPF 中的绑定控件

c_cpp 快速代码片段,用于在统计(阻止)/ dev / rdsk中的设备时验证fstat64和stat64的行为。

WPF 文本框 RaiseEvent

WPF xaml:如何使用自动生成的列验证 DataGrid 中的单元格

2021-09-29 WPF上位机 51-MVVM模式中的数据校验

Catel WPF 延迟验证