WPF快速指导5：验证

WPF快速指导5：验证
    本文摘要：
    1：WPF中的验证处理机制；
    2：自定义验证规则；
    3：如何显示验证错误信息
    4：指定何时进行验证

1：WPF中的验证处理机制
    接受用户输入的大多数应用程序都需要具有验证逻辑，以确保用户输入了需要的信息。验证检查可以基于类型、范围、格式或其他应用程序特定的要求。本节讨论了数据验证在 WPF 中的工作方式。

    先来看一个简单的例子

    <Window.Resources>
        <local:Person x:Key="luminji" Name="luminji" Age="3"></local:Person>
    </Window.Resources>
    <StackPanel DataContext="{StaticResource luminji}" >
        <TextBox x:Name="textBoxAge">
            <TextBox.Text>
                <Binding Path="Age" NotifyOnValidationError="True">
                    <Binding.ValidationRules>
                        <ExceptionValidationRule></ExceptionValidationRule>
                    </Binding.ValidationRules>
                </Binding>
            </TextBox.Text>
        </TextBox>
        <Button>Button</Button>
    </StackPanel>

     后台：

    public partial class Window1 : Window
    {
        public Window1()
        {
            InitializeComponent();
            Validation.AddErrorHandler(this.textBoxAge, delegate(object sender, ValidationErrorEventArgs e)
            {
                MessageBox.Show(e.Error.ErrorContent.ToString());
            });
        }
    }

    class Person
    {
        public string Name { get; set; }
        public int Age { get; set; }
    }

    WPF中的验证处理机制是：当验证结果出现非法数据时，就会产生一个包含错误信息的ValidationError对象供界面进行显示。在使用了ExceptionValidationRule的情况下，这个错误对象会包含验证规则所捕获到的Exception对象的Message属性。当然，为了，访问到这个异常，我们需要为页面的Validation对象添加附件事件，即上文中Validation.AddErrorHandler(……)。注意，为了能捕获这个事件，还需要将数据绑定中的NotifyOnValidationError设置为True。
    把这段代码运行起来，如果你在文本框中输入的不是数字，则会弹出ExceptionValidationRule中默认的“输入字符串的格式不正确”。但是显然，这种系统默认提供给我们的提示信息不能满足我们的要求。如果要对错误进行更多的自定义处理，首先就要自定义验证规则。

2：自定义验证规则
    自定义验证规则需要继承抽象类ValidationRule，并重写Validate方法。然后在XAML中的ExceptionValidationRule换成自定义的验证规则类就行。
    前台中相应替换的内容：

            <TextBox.Text>
                <Binding Path="Age" NotifyOnValidationError="True">
                    <Binding.ValidationRules>
                        <local:AgeRule></local:AgeRule>
                    </Binding.ValidationRules>
                </Binding>
            </TextBox.Text>

    后台的自定义验证类：

    class AgeRule: ValidationRule
    {

        public override ValidationResult Validate(object value, System.Globalization.CultureInfo cultureInfo)
        {
            int number;
            if (!int.TryParse((string)value, out number))
            {
                return new ValidationResult(false, "输入的内容必须为数字！");
            }
            else if( number > 100 || number < 0)
            {
                return new ValidationResult(false, "输入的年龄超过范围");
            }
            else
            {
                //return new ValidationResult(true, null);
                return ValidationResult.ValidResult;
            }
        }
    }

     我们注意到，上文中的100和0是硬编码，还有一种虽然是前台硬编码，但是看上去要舒服很多，见下文：
     前台中相应替换的内容：

            <TextBox.Text>
                <Binding Path="Age" NotifyOnValidationError="True">
                    <Binding.ValidationRules>
                        <local:AgeRule Max="100" Min="0"></local:AgeRule>
                    </Binding.ValidationRules>
                </Binding>
            </TextBox.Text>

     后台中相应变化的内容：

    class AgeRule: ValidationRule
    {
        public int Min { get; set; }
        public int Max { get; set; }
        public override ValidationResult Validate(object value, System.Globalization.CultureInfo cultureInfo)
        {
            int number;
            if (!int.TryParse((string)value, out number))
            {
                return new ValidationResult(false, "输入的内容必须为数字！");
            }
            else if( number > Max || number < Min)
            {
                return new ValidationResult(false, "输入的年龄超过范围");
            }
            else
            {
                //return new ValidationResult(true, null);
                return ValidationResult.ValidResult;
            }
        }
    }

3：如何显示验证错误信息
    在上文中，我们通过MessageBox来显示验证的错误信息。看上去有点业余，即用户友好度不够，更好的处理方法是在UI上指定一个固定的区域进行显示。指定固定区域进行显示有三种方法。
    第一种，是在Validation.AddErrorHandler为某个区域赋值错误信息。如下文代码中的textBlockErrorMessage0。
    第二种，是为区域绑定错误信息，如下文代码中的textBlockErrorMessage1。
    第三种，是为Validation.HasError设定触发器，指定Validation.ErrorTemplate来动态显示错误信息。
    提倡第三种做法。
    前台代码：

    <Window.Resources>
        <local:Person x:Key="luminji" Name="luminji" Age="3"></local:Person>
        <Style TargetType="{x:Type TextBox}">
            <Style.Triggers>
                <Trigger Property="Validation.HasError" Value="true">
                    <Setter Property="Validation.ErrorTemplate">
                        <Setter.Value>
                            <ControlTemplate>
                                <DockPanel LastChildFill="True">
                                    <TextBlock DockPanel.Dock="Right" Text="{Binding ElementName=MyAdorner, Path=AdornedElement.(Validation.Errors)[0].ErrorContent}">
                                    </TextBlock>
                                    <Border BorderBrush="Red" BorderThickness="1">
                                        <AdornedElementPlaceholder Name="MyAdorner"/>
                                    </Border>
                                </DockPanel>
                            </ControlTemplate>
                        </Setter.Value>
                    </Setter>
                </Trigger>
            </Style.Triggers>
        </Style>
    </Window.Resources>
    <StackPanel DataContext="{StaticResource luminji}" >
        <TextBox x:Name="textBoxAge" Width="100">
            <TextBox.Text>
                <Binding Path="Age" NotifyOnValidationError="True" UpdateSourceTrigger="PropertyChanged">
                    <Binding.ValidationRules>
                        <local:AgeRule Max="100" Min="0"></local:AgeRule>
                    </Binding.ValidationRules>
                </Binding>
            </TextBox.Text>
        </TextBox>
        <TextBlock x:Name="textBlockErrorMessage0"/>
        <TextBlock x:Name="textBlockErrorMessage1" Text="{Binding ElementName=textBoxAge, Path=(Validation.Errors)[0].ErrorContent}" />
        <Button>Button</Button>
    </StackPanel>

      后台代码代码因为和上文的后台代码没有太多区别，故略。
      值得注意的是，前台代码的触发器中，<TextBlock DockPanel.Dock="Right" Text="{Binding ElementName=MyAdorner, Path=AdornedElement.(Validation.Errors)[0].ErrorContent}">，AdornedElement这个属性不能少。AdornedElement表示的是当前装饰器所在的UIElement。

4：指定何时进行验证
    上文的例子中，我们都是在文本框失去焦点的时候看到验证的错误信息的。我们还可以指定这个验证的时机，就是为文本框的绑定设置UpdateSourceTrigger。如：<Binding Path="Age" NotifyOnValidationError="True" UpdateSourceTrigger="PropertyChanged">。就是指定每次输入字符就验证一次。