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">。就是指定每次输入字符就验证一次。

posted @ 2011-01-25 21:21  陆敏技  阅读(8118)  评论(1编辑  收藏  举报
Web Counter
Coupon for Contacts