Silverlight 4 Validation验证实例系列
Silverlight实例教程 - Validation数据验证开篇 Silverlight实例教程 - Validation数据验证基础属性和事件 Silverlight实例教程 - Validation数据验证DataAnnotation机制和调试技巧 Silverlight实例教程 - Validation客户端同步数据验证 Silverlight实例教程 - Validation服务器端异步数据验证 Silverlight实例教程 - Validation用户提交数据验证捕获 Silverlight实例教程 – Datagrid,Dataform数据验证和ValidationSummary Silverlight实例教程 - 自定义扩展Validation类,验证框架的总结和建议
在学习了Silverlight Validation数据验证基础属性和事件后,大家对Silverlight数据验证应该有了一个简单明了的认识。今天,我将继续介绍另外一种Silverlight的Validation验证机制,DataAnnotation。
在文章开始前,我想首先介绍一下Visual Studio中如何调试Silverlight的Validation代码。
Visual Studio 2010调试Silverlight Validation设置技巧
相信大家在运行上一篇的代码时会发现,在异常出现时,Visual Studio会自动中断和获取当前异常错误信息,这为调试带来了一些不便。
针对以上问题,我们可以在Visual Studio中进行简单设置,暂时取消在Debug模式下对异常的捕获,方法如下:
首先到Debug菜单,选择Exceptions菜单,也可以使用“Ctrl+Alt+E”,激活Exception窗口。
点击“Find”查找以下选项,System.Exception,将其后面的CheckBox取消选中。
这样就实现了当数据验证时,Visual Studio不再捕获异常错误。
对于本篇,我们将使用DataAnnotation验证机制,该验证机制与上一篇略有不同,所以,如果要实现Visual Studio忽略捕获异常,要另外在Exception窗口搜索“System.ComponentModel.DataAnnotations.ValidationException",同样将其后面的CheckBox取消选中。
Visual Studio 2008和Silverlight 3开发环境中,默认情况下Exception没有System.ComponentModel.DataAnnotations.ValidationException选项,开发人员可以自行添加一个新的异常即可,点击“Add”按钮,
在完成以上的操作后,再次执行Silverlight应用调试Validation时,Visual Studio不再出现异常捕获,相对方便很多。Silverlight DataAnnotation验证机制
验证Metadata属性
Silverlight的DataAnnotation验证机制是Silverlight 3发布WCF RIA Services测试版是推出的客户端验证机制,对于DataAnnotation的翻译,可以理解为“数据元素注释”验证法。该验证机制,使用了System.ComponentModel.DataAnnotations命名空间中的属性类,通过对DataMember数据成员设置Metadata元数据属性,对其验证值进行判断是否符合当前属性条件,以达到Validation的效果。该验证机制,多数运用于WCF RIA Services应用中.
1 private string _email;
2 [Required(ErrorMessage = "必填选项")]
3 public string email
4 {
5 get { return _email; }
6 set
7 {
8 _email = value;
9 }
10 }
从上面代码可以看到属性上面的注释 [Required(ErrorMessage = "必填选项")],该注释就是DataAnnotations类中的固有属性,其结果是判断该控件内容是否为空,如果是,则弹出异常。目前常用的DataAnnotation属性如下列表:
属性名称
描述
Required
标识该属性为必需参数,不能为空
StringLength
标识该字符串有长度限制,可以限制最小或最大长度
Range
标识该属性值范围,通常被用在数值型和日期型
RegularExpression
标识该属性将根据提供的正则表达式进行对比验证
CustomValidation
标识该属性将按照用户提供的自定义验证方法,进行数值验证
在随后的实例中,我们将一一演示这些属性的使用方法。
ValidationContext和Validator类
阅读过上一篇Silverlight Validation基础的朋友应该知道,Silverlight的数据验证,可以在数据成员的Setter中设置条件验证,根据其验证结果判断是否符合验证。例如:
1 private int _age;
2 public int Age
3 {
4 get { return _age; }
5 set
6 {
7 if (value > 100 || value < 0)
8 {
9 throw new Exception("请输入年龄值在0 - 100之间.");
10 }
11 _age = value;
12 }
13 }
在set中,判断年龄值是否超过100岁或者低于0岁,如果不符合条件,则抛出异常,该异常将被Validation机制捕获,并显示到UI。
而Silverlight的DataAnnotation机制,与上面验证方法不同。Silverlight的DataAnnotation验证机制,在添加验证属性后,不需要在Setter中进行验证判断,仅需要在Setter中激活该验证属性即可,而要实现激活验证,则需要使用ValidationContext和Validator类。为了更好的理解Silverlight DataAnnotation验证机制,我们来对这两个类进行简单的讲解,首先说说Validator类,该类是一个静态类,主要用来当数据成员被指定验证元数据属性时,验证对象,属性和方法。简单的理解就是包含了各种具体验证方法的类。例如上文代码,我们使用了Require验证属性,Validator类将会根据该验证属性执行对应的验证方法,对目标值进行判断。在该类中,包含ValidateProperty方法和TryValidateProperty方法,可以分别对当前属性进行验证操作。
而ValiationContext类,该类是对当前执行的数据验证提供上下文描述的。简单的理解,也就是为验证提供数据传输,属性标识等任务。
我们对email属性,进行简单的修改,添加以上两个类,让该属性Silverlight的DataAnnotation机制生效。
1 private string _email;
2 [Required(ErrorMessage = "必填选项")]
3 public string email
4 {
5 get { return _email; }
6 set
7 {
8 var tmpValidator = new ValidationContext(this, null, null);
9 tmpValidator.MemberName = "email";
10 Validator.ValidateProperty(value, tmpValidator);
11 _email = value;
12 }
13 }
在上文代码中,我们定义一个ValidationContext实例,该实例中包含了需要验证对象的引用,并且,我们定义了验证对象的MemberName,通过调用Validator.ValidateProperty静态方法,检查目标数据是否符合当前验证属性,如果返回False,则抛出一个ValidationException。上面代码也可简写为:
1 Validator.ValidateProperty(value, new ValidationContext(this, null, null) { MemberName = "email" });
当运行实例后,输入空格在邮件文本框中,Silverlight的DataAnnotation验证机制将被激活,生成如下效果:
在理解了上面的Silverlight的DataAnnotation验证机制的基本类和属性后,我们可以做几个简单的实例,来加深理解。
1. StringLength,定义Password密码框最大可输入6个字符,
1 <StackPanel Orientation="Horizontal" Margin="5">
2 <TextBlock Text="密 码: " VerticalAlignment="Center"/>
3 <TextBox x:Name="txtPassword" Width="200" DataContext="{Binding Source={StaticResource UserDataContext}}" Text="{Binding Path=password, Mode=TwoWay,ValidatesOnExceptions=True, NotifyOnValidationError=True}" />
4 </StackPanel> 1 private string _password;
2 [StringLength(6, ErrorMessage="密码不能超过6个字符")]
3 public string password
4 {
5 get { return _password; }
6 set
7 {
8 &nb