Validation数据验证基础属性和事件
最后更新于:2022-04-01 14:20:54
![](https://docs.gechiui.com/gc-content/uploads/sites/kancloud/2016-03-18_56eb67c868925.jpg)
[上篇](http://www.cnblogs.com/jv9/admin/Silverlight实例教程%20-%20Validation数据验证开篇)介绍了Silverlight的Validation数据验证的好处和概述,其中了解到Silverlight数据验证方法可以被抽象为语法验证和语义验证,其中前者是通过数据类型定义对比验证,而后者是通过当前输入数据根据特定数据限制代码进行验证。本篇将在以上抽象方法的基础上结合实例,介绍Silverlight Validation数据验证类中常用属性和方法。
本篇,我们将创建一个新的实例项目,SilverlightValidationDemo
![](https://docs.gechiui.com/gc-content/uploads/sites/kancloud/2016-03-18_56eb67cb339de.jpg)
在MainPage,创建简单的用户交互界面:
![](https://docs.gechiui.com/gc-content/uploads/sites/kancloud/2016-03-18_56eb67cb4818f.jpg)
另外需要准备一个简单的数据成员类,方便随后的演示,
![](https://docs.gechiui.com/gc-content/uploads/sites/kancloud/2016-03-18_56eb67cb55d3e.jpg)
在实例演示前,我们仍旧需要先学习一下Silverlight的Validation数据验证框架基础属性和事件,
首先需要了解的是
[BindingValidationError](http://msdn.microsoft.com/en-us/library/system.windows.frameworkelement.bindingvalidationerror(v=VS.95).aspx)事件
该事件是一个路由事件,当数据验证错误出现时,将绑定该错误到数据源;也可以简单的理解为绑定错误到数据源的一个行为。该事件可在控件本身调用,也可在其父控件中调用。例如,在TextBox中,可以声明调用BindingValidationError,或者可以该TextBox的父容器控件Grid,StackPanel中调用BindingValidationError事件。这里需要注意的是,如果在Silverlight的MVVM设计模式下,仅在被验证的控件本身激活BindingValidationError事件,才能正常的被UI捕获到错误信息,不支持在父控件中对BindingValidationError事件进行调用。
为了保证Validation的灵活性,微软同时提供了相关属性,来控制BindingValidationError事件的调用。NotifyOnValidationError和ValidatesOnExceptions属性。
[NotifyOnValidationError](http://msdn.microsoft.com/en-us/library/system.windows.data.binding.notifyonvalidationerror(VS.95).aspx)属性
该属性的功能,是当验证错误出现时是否激活BindingValidationError事件;该属性是Silverlight独有的验证属性之一,经常和ValidatesOnExceptions属性配合使用。
[ValidatesOnExceptions](http://msdn.microsoft.com/en-us/library/system.windows.data.binding.validatesonexceptions(v=VS.95).aspx)属性
该属性的功能,数据绑定引擎是否捕获显示异常错误作为验证错误。简单的理解,在控件绑定数据时,出现数据源异常抛出,或者数据类型转换时异常抛出,是否作为Validation验证显示在客户端。如果是True,则会按照Validation传统的处理方式,弹出一个红色说明标签,内容是异常错误信息,反之,则不捕获异常作为Validation。
对于Silverlight开发新手而言,初次看到以上概念,会有混淆,请继续看下面实例,结合实例来理解以上的属性和事件使用方法。
首先,我们在MainPage中,将我们起初定义的User类添加作为一个静态数据源,
~~~
xmlns:local="clr-namespace:SilverlightValidationDemo"
~~~
~~~
<UserControl.Resources>
<local:User x:Key="UserDataContext"/>
</UserControl.Resources>
~~~
对于控件数据绑定,在Visual Studio中可以通过视图设定,也可以直接敲入代码设定,这里,我们使用视图的方法,减少代码输入量,
在MainPage中,选中txtUserName文本框,右键选择属性,
![](https://docs.gechiui.com/gc-content/uploads/sites/kancloud/2016-03-18_56eb67cb69dba.jpg)
在属性框中,设置绑定数据源,
![](https://docs.gechiui.com/gc-content/uploads/sites/kancloud/2016-03-18_56eb67cb7ad14.jpg)
选择Common - DataContext,然后选择“Apply Data Binding.." 选择数据源
![](https://docs.gechiui.com/gc-content/uploads/sites/kancloud/2016-03-18_56eb67cb8cd5e.jpg)
这里,数据源可以选择外部数据源,也可以选择Element绑定源,我们则使用StaticResource静态数据源,也就是我们刚才创建的UserDataContext,
![](https://docs.gechiui.com/gc-content/uploads/sites/kancloud/2016-03-18_56eb67cba06ca.jpg)
选中后,绑定数据源已经完成,则需要设置控件绑定字段设置,选择Common - Text属性,
![](https://docs.gechiui.com/gc-content/uploads/sites/kancloud/2016-03-18_56eb67cbb8da0.jpg)
然后选择 Apply Data Binding...,进入后可以看到,数据源,已经绑定为“DataContext - User”,而数据源中的成员名称已经被自动列出,
![](https://docs.gechiui.com/gc-content/uploads/sites/kancloud/2016-03-18_56eb67cbcc638.jpg)
我们需要指定绑定成员名称,
![](https://docs.gechiui.com/gc-content/uploads/sites/kancloud/2016-03-18_56eb67cbdb36f.jpg)
然后,选择“Options”,在选项中,选中“NotifyOnValidationError”和“ValidatesOnExceptions”,
![](https://docs.gechiui.com/gc-content/uploads/sites/kancloud/2016-03-18_56eb67cbeae71.jpg)
这样控件绑定设置已经完成了,这时,可以切换到Xaml代码界面查看一下当前txtUserName的代码可以发现,Visual Studio 2010已经自动生成了绑定代码,如下:
~~~
<TextBox x:Name="txtUserName" Width="200" DataContext="{Binding Source={StaticResource UserDataContext}}" Text="{Binding Path=Name, Mode=TwoWay, ValidatesOnExceptions=True, NotifyOnValidationError=True}" />
~~~
现在,我们在name数据成员属性中,添加简单的判断代码:
~~~
private string _name;
public string Name
{
get { return _name; }
set
{
if (string.IsNullOrEmpty(value))
{
throw new Exception("用户名不能为空.");
}
_name = value;
}
}
~~~
![](https://docs.gechiui.com/gc-content/uploads/sites/kancloud/2016-03-18_56eb67cc0904a.jpg)
这样一个简单的Validation数据验证功能就完成了。
大家可以试着将ValidatesOnExceptions=True代码设为False,看看是否还能捕获异常验证?
下面,看看BindingValidationError事件和NotifyOnValidationError属性的应用,
我们添加一个TextBlock控件,用来显示验证异常信息,
~~~
<StackPanel Orientation="Horizontal" >
<TextBlock x:Name="tbMessage" Margin="5" Foreground="Red"/>
</StackPanel>
~~~
在MainPage中的LayoutRoot布局控件中,添加BindingValidationError事件,
~~~
<Grid x:Name="LayoutRoot" Background="White" BindingValidationError="LayoutRoot_BindingValidationError">
~~~
后台定义:
~~~
private void LayoutRoot_BindingValidationError(object sender, ValidationErrorEventArgs e)
{
if (e.Action == ValidationErrorEventAction.Added)
{
(e.OriginalSource as Control).Background = new SolidColorBrush(Colors.Yellow);
tbMessage.Text= e.Error.Exception.Message;
}
if (e.Action == ValidationErrorEventAction.Removed) {
(e.OriginalSource as Control).Background = new SolidColorBrush(Colors.White);
tbMessage.Text = "";
}
}
~~~
在验证异常出现时,由于NotifyOnValidationError属性设置为True,所以,会执行BindingValidationError事件,
其中tbMessage会显示验证错误信息,而验证控件样式也会有改变。
![](https://docs.gechiui.com/gc-content/uploads/sites/kancloud/2016-03-18_56eb67cc1d35e.jpg)
大家可以试着将NotifyOnValidationError属性设置为False,会发现BindingValidationError事件将不再执行。
今天,就讲到这里了。本篇讲述的两个属性和一个事件,是Silverlight的Validation最基础的知识点,在随后的文章中会频繁出现,希望大家能够认真理解。
[源代码下载](http://www.silverlightchina.net/uploads/soft/100908/1-100ZQ44358.rar)
欢迎大家加入"专注Silverlight" 技术讨论群:
32679955(六群)
23413513(五群)
32679922(四群)
100844510(三群)
37891947(二群)
22308706(一群)