WPF中的binding（十）- Binding数据的校验

最新推荐文章于 2025-05-15 11:43:31 发布

原创最新推荐文章于 2025-05-15 11:43:31 发布 · 3.3k 阅读

1 ·

CC 4.0 BY-SA版权

WPF 专栏收录该内容

30 篇文章

订阅专栏

本文介绍了如何使用WPF中的Binding特性来实现数据的有效性验证，包括对外部方法更新操作的验证、对源数据的验证以及如何展示验证失败的信息。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

Binding的ValidationRules属性的类型是Collection<ValidationRule>，从它的名称可以看见，每个 Binding可以接收多个校验条件，每个条件都是ValidationRule对象。
一、校验外部方法的更新操作

首先，新建一个WPF项目，Xmal文件的代码如下：

<Window x:Class="_6_31.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        Title="MainWindow" Height="350" Width="525">
    <Grid>
        <TextBox Height="23" HorizontalAlignment="Left" Margin="52,66,0,0" Name="textBox1" VerticalAlignment="Top" Width="409" />
        <Slider Height="23" HorizontalAlignment="Left" Margin="52,150,0,0" Name="slider1" VerticalAlignment="Top" Width="409" />
    </Grid>
</Window>

界面上放置一个TextBox和一个Slider，我们要对TextBox的输入值进行校验。首先需要准备一个ValidationRule派生类：

public class RangeValidationRule : ValidationRule
    {
        //需¨¨要°a实º¦Ì现?Validate方¤?法¤¡§
        public override ValidationResult Validate(object value, System.Globalization.CultureInfo cultureInfo)
        {
            double d = 0;
            if (double.TryParse(value.ToString(), out d) == true)
            {
                if (d >= 0 && d <= 100)
                {
                    return new ValidationResult(true, null);
                }
            }
            return new ValidationResult(false,"Validation Error");
        }
    }

可以看到，在该派生类中，我们需要实现Validate方法，该方法的返回值类型为ValidationResult，如果校验成功，ValidationResult的IsVaild的属性会被置为True；如果校验失败，ValidationResult的IsVaild的属性会被置为False，并为其ErrorContent属性设置一个合适的消息的内容。
然后，我们在后台建立Binding：

public MainWindow()
        {
            InitializeComponent();

            Binding binding = new Binding("Value") { Source = this.slider1 };
            binding.UpdateSourceTrigger = UpdateSourceTrigger.PropertyChanged;
            RangeValidationRule rule = new RangeValidationRule();
            binding.ValidationRules.Add(rule);
            this.textBox1.SetBinding(TextBox.TextProperty, binding);
        }

运行效果如下，当我们输入不在[0,100]范围内的数字时，textBox1会出现红色的边缘，表示校验错误。

二、校验Source的数据
接下来，我们将slider1的取值范围调成-20~120，发现将其调到超过0~100的范围时，textBox1反而没有进行校验。

这是因为上面我们设置的校验只在用户对Binding目标（textBox1）输入时进行校验，而对Binding的Source（slider1）传过来的数据不会进行校验。如果想要设置同时校验Source数据，我们需要将校验规则的ValidatesOnTargetUpdated设置为True。构造代码如下：

public MainWindow()
        {
            InitializeComponent();

            Binding binding = new Binding("Value") { Source = this.slider1 };
            binding.UpdateSourceTrigger = UpdateSourceTrigger.PropertyChanged;
            RangeValidationRule rule = new RangeValidationRule();
            rule.ValidatesOnTargetUpdated = true;
            binding.ValidationRules.Add(rule);
            this.textBox1.SetBinding(TextBox.TextProperty, binding);
        }

实现效果如下：

三、校验失败的信息显示
当校验失败时，Validate 返回的ValidationResult携带了一条错误信息，我们怎么在界面上显示这个错误信息呢？
首先，需要把Binding对象的NotifyOnValidationError置为true。这样当数据校验失败时，Binding就会发出一个信息，以Binding对象的Target为起点，沿着UI元素树向上传播。信号每到达一个节点，如果节点设置了对这个信号的侦听器（事件处理器），那么这个侦听器就会被触发处理这个信号。

public MainWindow()
        {
            InitializeComponent();

            Binding binding = new Binding("Value") { Source = this.slider1 };
            binding.UpdateSourceTrigger = UpdateSourceTrigger.PropertyChanged;
            RangeValidationRule rule = new RangeValidationRule();
            rule.ValidatesOnTargetUpdated = true;
            binding.ValidationRules.Add(rule);

            binding.NotifyOnValidationError = true;
            this.textBox1.SetBinding(TextBox.TextProperty, binding);
        }

接下来，我们就创建这样一个事件处理器：

public MainWindow()
        {
            InitializeComponent();

            Binding binding = new Binding("Value") { Source = this.slider1 };
            binding.UpdateSourceTrigger = UpdateSourceTrigger.PropertyChanged;
            RangeValidationRule rule = new RangeValidationRule();
            rule.ValidatesOnTargetUpdated = true;
            binding.ValidationRules.Add(rule);

            //设¦¨¨置?NotifyOnValidationError=true，ê?一°?旦Ì?校¡ê验¨¦失º¡ì败ã¨¹就¨ª触ä£¤发¤¡é信?号?
            binding.NotifyOnValidationError = true;
            this.textBox1.SetBinding(TextBox.TextProperty, binding);

            //关?联¢a校¡ê验¨¦失º¡ì败ã¨¹的Ì?事º?件t处ä|理¤¨ª器¡Â
            this.textBox1.AddHandler(Validation.ErrorEvent,new RoutedEventHandler(this.ValidationError));
        }

        void ValidationError(object sender, RoutedEventArgs e)
        {
            if (Validation.GetErrors(this.textBox1).Count > 0)
            {
                this.textBox1.ToolTip = Validation.GetErrors(this.textBox1)[0].ErrorContent.ToString();
            }
        }

运行效果如下，可以看到错误信息已经显示到了textBox1的ToolTip上：