Silverlight输入数据验证系列-

Silverlight实例教程 - Validation数据验证基础属性和事件

时间:2010-09-08 14:41 来源:SilverlightChina.Net 作者:Jv9 点击: 367次

上篇介绍了Silverlight的Validation数据验证的好处和概述，其中了解到Silverlight数据验证方法可以被抽象为语法验证和语义验证，其中前者是通过数据类型定义对比验证，而后者是通过当前输入数据根据特定数据限制代码进行验证。本篇将在以上抽象方法的基础上结合实例，介

　　

 

 

上篇介绍了Silverlight的Validation数据验证的好处和概述，其中了解到Silverlight数据验证方法可以被抽象为语法验证和语义验证，其中前者是通过数据类型定义对比验证，而后者是通过当前输入数据根据特定数据限制代码进行验证。本篇将在以上抽象方法的基础上结合实例，介绍Silverlight Validation数据验证类中常用属性和方法。

 

本篇，我们将创建一个新的实例项目，SilverlightValidationDemo

 

 

在MainPage，创建简单的用户交互界面：

 

另外需要准备一个简单的数据成员类，方便随后的演示，

 

在实例演示前，我们仍旧需要先学习一下Silverlight的Validation数据验证框架基础属性和事件，

首先需要了解的是

 

BindingValidationError事件

该事件是一个路由事件，当数据验证错误出现时，将绑定该错误到数据源；也可以简单的理解为绑定错误到数据源的一个行为。该事件可在控件本身调用，也可在其父控件中调用。例如，在TextBox中，可以声明调用BindingValidationError，或者可以该TextBox的父容器控件Grid，StackPanel中调用BindingValidationError事件。这里需要注意的是，如果在Silverlight的MVVM设计模式下，仅在被验证的控件本身激活BindingValidationError事件，才能正常的被UI捕获到错误信息，不支持在父控件中对BindingValidationError事件进行调用。

 

为了保证Validation的灵活性，微软同时提供了相关属性，来控制BindingValidationError事件的调用。NotifyOnValidationError和ValidatesOnExceptions属性。

 

NotifyOnValidationError属性

该属性的功能，是当验证错误出现时是否激活BindingValidationError事件；该属性是Silverlight独有的验证属性之一，经常和ValidatesOnExceptions属性配合使用。

 

ValidatesOnExceptions属性

该属性的功能，数据绑定引擎是否捕获显示异常错误作为验证错误。简单的理解，在控件绑定数据时，出现数据源异常抛出，或者数据类型转换时异常抛出，是否作为Validation验证显示在客户端。如果是True，则会按照Validation传统的处理方式，弹出一个红色说明标签，内容是异常错误信息，反之，则不捕获异常作为Validation。

 

对于Silverlight开发新手而言，初次看到以上概念，会有混淆，请继续看下面实例，结合实例来理解以上的属性和事件使用方法。

 

首先，我们在MainPage中，将我们起初定义的User类添加作为一个静态数据源，

 

1  xmlns:local="clr-namespace:SilverlightValidationDemo"

 

 

1  < UserControl.Resources >
2           < local:User  x:Key ="UserDataContext" />
3  </ UserControl.Resources >

 

 

对于控件数据绑定，在Visual Studio中可以通过视图设定，也可以直接敲入代码设定，这里，我们使用视图的方法，减少代码输入量，

在MainPage中，选中txtUserName文本框，右键选择属性，

 

在属性框中，设置绑定数据源,

 

选择Common - DataContext，然后选择“Apply Data Binding.." 选择数据源

 

 

这里，数据源可以选择外部数据源，也可以选择Element绑定源，我们则使用StaticResource静态数据源，也就是我们刚才创建的UserDataContext，

 

 

选中后，绑定数据源已经完成，则需要设置控件绑定字段设置，选择Common - Text属性，

 

然后选择 Apply Data Binding...，进入后可以看到，数据源，已经绑定为“DataContext - User”，而数据源中的成员名称已经被自动列出，

 

我们需要指定绑定成员名称，

 

然后，选择“Options”，在选项中，选中“NotifyOnValidationError”和“ValidatesOnExceptions”，

 

这样控件绑定设置已经完成了，这时，可以切换到Xaml代码界面查看一下当前txtUserName的代码可以发现，Visual Studio 2010已经自动生成了绑定代码，如下：

 

1  < TextBox  x:Name ="txtUserName"  Width ="200"  DataContext =" {Binding Source={StaticResource UserDataContext}} "  Text =" {Binding Path=Name, Mode=TwoWay, ValidatesOnExceptions=True, NotifyOnValidationError=True} "   />

 

 

现在，我们在name数据成员属性中，添加简单的判断代码：

 

 1  private   string  _name;
 2  public   string  Name
 3  {
 4               get  {  return  _name; }
 5               set  
 6              {
 7                   if  ( string .IsNullOrEmpty(value))
 8                  {
 9                       throw   new  Exception( " 用户名不能为空. " );
10                  }
11                  _name  =  value; 
12              }
13  }

 

 

 

 

这样一个简单的Validation数据验证功能就完成了。

大家可以试着将ValidatesOnExceptions=True代码设为False，看看是否还能捕获异常验证？

下面，看看BindingValidationError事件和NotifyOnValidationError属性的应用，

我们添加一个TextBlock控件，用来显示验证异常信息，

 

1  < StackPanel  Orientation ="Horizontal"   >
2          < TextBlock  x:Name ="tbMessage"  Margin ="5"  Foreground ="Red" />
3  </ StackPanel >

 

 

在MainPage中的LayoutRoot布局控件中，添加BindingValidationError事件，

 

1  < Grid  x:Name ="LayoutRoot"  Background ="White"  BindingValidationError ="LayoutRoot_BindingValidationError" >

 

 

后台定义：

 

 1  private   void  LayoutRoot_BindingValidationError( object  sender, ValidationErrorEventArgs e)
 2  {
 3               if  (e.Action  ==  ValidationErrorEventAction.Added)
 4              {
 5                  (e.OriginalSource  as  Control).Background  =   new  SolidColorBrush(Colors.Yellow);
 6                  tbMessage.Text =  e.Error.Exception.Message;
 7              }
 8 
 9               if  (e.Action  ==  ValidationErrorEventAction.Removed)
10              {
11                  (e.OriginalSource  as  Control).Background  =   new  SolidColorBrush(Colors.White);
12                  tbMessage.Text  =   "" ;
13              }
14  }

 

 

在验证异常出现时，由于NotifyOnValidationError属性设置为True，所以，会执行BindingValidationError事件，

其中tbMessage会显示验证错误信息，而验证控件样式也会有改变。

 

大家可以试着将NotifyOnValidationError属性设置为False，会发现BindingValidationError事件将不再执行。

 

今天，就讲到这里了。本篇讲述的两个属性和一个事件，是Silverlight的Validation最基础的知识点，在随后的文章中会频繁出现，希望大家能够认真理解。

 

 

源代码下载