WPF---數據綁定之ValidationRule數據校驗（六）

一、概述

我們知道，Binding好比架設在Source和Target之間的橋梁，數據可以借助這個橋梁進行流通。在數據流通的過程中，我們可以在Binding這座橋梁上設置關卡，對數據的有效性進行驗證。

二、驗證方法

我們利用Binding的ValidationRules（類型為Collection<ValidationRule）對數據進行驗證。從它的名稱和類型可以得知，我們可以為每個Binding設置多個數據校驗條件，每個條件是一個

ValidationRule對象，ValidationRule類是個抽象類，使用的時候，我們需要創建它的派生類並實現它的Validate方法。

Validate方法返回值是ValidationResult類型對象，如果校驗通過，需要把ValidationResult對象的IsValid屬性設置為true，反之，設置false並為其ErrorContent屬性設置一個合適的消息內容，一般情況下是一個字符串。

三、例子

Demo1

假設UI上有一個Slider和一個TextBox，我們以Slider為源，TextBox為Target，Slider的取值范圍為0~100，也就是說我們要需要校驗TextBox中輸入的值是不是在1~100這個范圍內。

using System.Globalization;
using System.Windows;
using System.Windows.Controls;

namespace BindingDemo4ValidationRule
{
    /// <summary>
    /// Interaction logic for MainWindow.xaml
    /// </summary>
    public partial class MainWindow : Window
    {
        public MainWindow()
        {
            InitializeComponent();
        }
    }
    public class RangeValidationRule:ValidationRule
    {
        public override ValidationResult Validate(object value, CultureInfo cultureInfo)
        {
            double myValue = 0;
            if(double.TryParse(value.ToString(),out myValue))
            {
                if (myValue >= 0 && myValue <= 100)
                {
                    return new ValidationResult(true, null);
                }
            }
            return new ValidationResult(false, "Input should between 0 and 100");
        }
    }
}

<Window x:Class="BindingDemo4ValidationRule.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
        xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
        xmlns:local="clr-namespace:BindingDemo4ValidationRule"
        mc:Ignorable="d"
        Title="MainWindow" Height="350" Width="525">
    <Grid>
        <Slider Margin="10,120,-10,-120" Minimum="0" Maximum="100" Name="slider" Value="10"></Slider>
        <TextBox Height="50" Margin="5,30,5,240" >
            <TextBox.Text>
                <Binding ElementName="slider" Path="Value" UpdateSourceTrigger="PropertyChanged">
                    <Binding.ValidationRules>
                        <local:RangeValidationRule/>
                    </Binding.ValidationRules>
                </Binding>
            </TextBox.Text>
        </TextBox>
      
    </Grid>
</Window>

運行結果如下：

 從結果中可以看出，當我們在TextBox中輸入的值不在0~100的范圍內的時候，TextBox會顯示紅色邊框，提示值是錯誤的。

 

Demo2

默認情況下，Binding校驗默認來自Source的數據總是正確的，只有來自Target的數據（Target多為UI控件，等價於用戶的輸入）才有可能出現問題，為了不讓有問題的數據污染Source，所以需要校驗。換句話說，Binding只在Target被外部更新時候進行校驗，而來自Binding的Source數據更新Target時是不會進行校驗的。

當來自Source的數據也有可能出現問題的時候，我們需要將校驗條件的ValidatesOnTargetUpdated屬性設置為true。

我們把Xaml代碼改為以下的時候，會發現當移動滑動條在0以下或者100以上的時候，TextBox邊框也會變成紅色。

<Window x:Class="BindingDemo4ValidationRule.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
        xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
        xmlns:local="clr-namespace:BindingDemo4ValidationRule"
        mc:Ignorable="d"
        Title="MainWindow" Height="350" Width="525">
    <Grid>
        <Slider Margin="10,120,10,-120" Minimum="-10" Maximum="110" Name="slider" Value="10"></Slider>
        <TextBox Height="50" Margin="5,30,5,240" >
            <TextBox.Text>
                <Binding ElementName="slider" Path="Value" UpdateSourceTrigger="PropertyChanged">
                    <Binding.ValidationRules>
                        <local:RangeValidationRule ValidatesOnTargetUpdated="True"/>
                    </Binding.ValidationRules>
                </Binding>
            </TextBox.Text>
        </TextBox>
      
    </Grid>
</Window>

Demo3

當校驗發生錯誤的時候，Validate方法返回的ValidationResult對象會攜帶一條錯誤消息，下面我們就要顯示這個錯誤消息。

為了達到這個目的，我們需要把Binding的NotifyOnValidationError屬性設置為true，這樣當數據校驗失敗的時候，Binding會像報警一樣發出一個信號，這個信號會以Binding對象的Target為起點在UI樹上傳播，如果某個節點上設置了對這種信號的偵聽器，那么這個偵聽器就會觸發來處理這個信號。詳細參加以下代碼：

using System.Globalization;
using System.Windows;
using System.Windows.Controls;

namespace BindingDemo4ValidationRule
{
    /// <summary>
    /// Interaction logic for MainWindow.xaml
    /// </summary>
    public partial class MainWindow : Window
    {
        public string TipMessage
        {
            get { return (string)GetValue(TipMessageProperty); }
            set { SetValue(TipMessageProperty, value); }
        }

        // Using a DependencyProperty as the backing store for TipMessage.  This enables animation, styling, binding, etc...
        public static readonly DependencyProperty TipMessageProperty =
            DependencyProperty.Register("TipMessage", typeof(string), typeof(MainWindow), new PropertyMetadata("Tip"));

        public MainWindow()
        {
            InitializeComponent();
            this.DataContext = this;
        }

        private void tbx1_Error(object sender, ValidationErrorEventArgs e)
        {
            if (Validation.GetErrors(tbx1).Count > 0)
            {
                TipMessage = Validation.GetErrors(tbx1)[0].ErrorContent.ToString();
            }
            else
            {
                TipMessage = "";
            }
        }
    }
    public class RangeValidationRule : ValidationRule
    {
        public override ValidationResult Validate(object value, CultureInfo cultureInfo)
        {
            double myValue = 0;
            if (double.TryParse(value.ToString(), out myValue))
            {
                if (myValue >= 0 && myValue <= 100)
                {
                    return new ValidationResult(true, null);
                }
            }

            return new ValidationResult(false, "Input should between 0 and 100");
        }
    }
}

<Window x:Class="BindingDemo4ValidationRule.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
        xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
        xmlns:local="clr-namespace:BindingDemo4ValidationRule"
        mc:Ignorable="d"
        Title="MainWindow" Height="350" Width="525">
    <Grid>
        <Slider Margin="10,120,10,-120" Minimum="-10" Maximum="110" Name="slider" Value="10"></Slider>
        <TextBox Height="50" Margin="5,30,5,240" Name="tbx1" Validation.Error="tbx1_Error">
            <TextBox.Text>
                <Binding ElementName="slider" Path="Value" UpdateSourceTrigger="PropertyChanged" NotifyOnValidationError="True">
                    <Binding.ValidationRules>
                        <local:RangeValidationRule ValidatesOnTargetUpdated="True"/>
                    </Binding.ValidationRules>
                </Binding>
            </TextBox.Text>
        </TextBox>
        <Label Height="50" Margin="5,154,-5,116" Content="{Binding TipMessage}" Foreground="Red"> 
            
        </Label>
      
    </Grid>
</Window>

運行結果以下：