Silverlight 4 Validation验证明例系列
在以往的Validation系列中,介绍了四种Silverlight验证机制:html
- 基本异常验证机制;
- DataAnnotation验证机制;
- IDataErrorInfo客户端同步验证机制;
- INotifyDataErrorInfo服务器端异步验证机制;
在每篇的实例中,你们都能发现这几种Silverlight Validation机制是根据异常主动触发的验证机制。本文将介绍另一种经常使用验证方法,该验证方法是基于以上四种验证机制,咱们称之为被动型触发验证。express
概述windows
被动型触发验证,简单的理解,就是当用户交互时,经过用户行为被动激活Validation验证机制。简 单的例子,一个须要注册用户的页面,其表格中,没有任何填写数据,而初始化后,对该表格不进行验证处理,仅当用户点击“注册”按钮后,对须要填写的控件进 行验证判断,这时就须要用到被动型触发验证。服务器
UpdateSourceTrigger属性框架
UpdateSourceTrigger属性是Validation数据验证的重要属性之一,该属性主要表示数据源触发更新的执行时间。主要运用在Binding中,例如:异步
<
TextBox
Text
="{Binding Username, Mode=TwoWay, NotifyOnValidationError=True, ValidatesOnDataErrors=True,
ValidatesOnExceptions=True, UpdateSourceTrigger=Explicit}"
/>
经过MSDN,咱们能够了解到UpdateSourceTrigger属性有两个值。spa
1. Default,该值返回目标依赖属性的默认UpdateSourceTrigger值,多数控件返回的默认值为PropertyChanged,而Text属性的默认值为LostFocus。.net
2. Explicit,若是设置UpdateSourceTrigger属性设置为显式方式,则须要开发人员手工调用UpdateSource方法,才能对数据源更新事件进行触发,不然不作任何操做。3d
在默认状况下,UpdateSourceTrigger属性为Default。这也就是尽管在前几篇的实例中,在Binding中,咱们没有设 置任何PropertyChanged信息,仍旧可以触发验证。当数据绑定被修改后,绑定会自动触发UpdateSourceTrigger属性,经过该 属性,对绑定数据源的数据成员进行验证,若是有异常,则返回False,反之为True。调试
提交数据验证捕获实例
在文章开始,咱们介绍了被动型触发验证方法,该方法在实际项目中是经常使用功能之一。前文说起的一个例子,注册时,想要在用户点击“注册”按钮时对 全部填写值使用Validation功能进行判断,其实现方法则须要将UpdateSourceTrigger属性设为Explicit,在后台中,咱们 使用代码控制其验证,经过这种方法,对提交数据进行验证捕获操做。
下面的例程,咱们仍旧使用SilverlightValidationDemo项目,若是你没有该项目,能够到上一篇下载该项目源代码,在本例中,咱们将尝试点击提交注册按钮,可是在点击“注册”时,对姓名,密码和年龄进行验证判断。在没有对代码修改前,点击“注册”按钮,页面不会捕获任何数据提交验证,们将对姓名,密码和年龄代码进行简单修改。
<
StackPanel
Orientation
="Horizontal"
Margin
="5"
>
<
TextBlock
Text
="用户名: "
VerticalAlignment
="Center"
/>
<
TextBox
x:Name
="txtUserName"
Width
="200"
DataContext
="
{Binding Source={StaticResource UserDataContext}}
"
Text
="
{Binding Path=Name, Mode=TwoWay, ValidatesOnExceptions=True, NotifyOnValidationError=True,UpdateSourceTrigger=Explicit}
"
/>
</
StackPanel
>
<
StackPanel
Orientation
="Horizontal"
Margin
="5"
>
<
TextBlock
Text
="密 码: "
VerticalAlignment
="Center"
/>
<
TextBox
x:Name
="txtPassword"
Width
="200"
DataContext
="
{Binding Source={StaticResource UserDataContext}}
"
Text
="
{Binding Path=password, Mode=TwoWay,ValidatesOnExceptions=True, NotifyOnValidationError=True,UpdateSourceTrigger=Explicit}
"
/>
</
StackPanel
>
<
StackPanel
Orientation
="Horizontal"
Margin
="5"
>
<
TextBlock
Text
="年 龄: "
VerticalAlignment
="Center"
/>
<
TextBox
x:Name
="txtAge"
Width
="200"
DataContext
="
{Binding Source={StaticResource UserDataContext}}
"
Text
="
{Binding Path=Age, Mode=TwoWay, NotifyOnValidationError=True, ValidatesOnExceptions=True,UpdateSourceTrigger=Explicit}
"
/>
</
StackPanel
>
从上面代码能够看出,咱们在Binding中,添加UpdateSourceTrigger=Explicit,根据上文提示,咱们必须手工对 数据源进行更新触发。这里须要解释一点,若是UpdateSourceTrigger=Default,当绑定模式为Twoway时,TextBox失去 焦点,则会触发数据源更新,这一切都有Silverlight API控制,而咱们设置UpdateSourceTrigger=Explicit后,则由开发人员控制。
UpdateSourceTrigger设置为Explicit后,咱们须要手动调用UpdateSource,才能对数据源进行验证。在UpdateSource前,咱们须要使用代码获取到绑定对象的实例。获取绑定对象实例,须要使用到BindingExpression类,BindingExpression类中包含了一个绑定对象实例的全部信息。而获取一个BindingExpression对象,则须要使用GetBindingExpression方法,对验证目标对象属性进行捕获。例如,咱们实例中的代码:
BindingExpression beUsername
=
txtUserName.GetBindingExpression(TextBox.TextProperty);
beUsername.UpdateSource();
经过txtUserName.GetBindingExpression获取TextBox对象的TextProperty绑定属性,而后赋值 到beUsername。而后调用UpdateSource方法,实现手工更新数据源,同时,数据源的修改,天然也就被动激活了后台的验证机制。在实际项 目中,仅获取到了验证错误信息,仍是不够的,页面仍是会继续进行下一步流程代码,而这里,咱们将会使用Validation类中的方法和属性,对验证错误 进行简单的判断。
private
void
btReg_Click(
object
sender, RoutedEventArgs e)
{
BindingExpression beUsername
=
txtUserName.GetBindingExpression(TextBox.TextProperty);
beUsername.UpdateSource();
if
(Validation.GetHasError(txtUserName))
return
;
}
上面代码,使用Validation类中的GetHasError()方法确认验证是否有错误,若是有,则返回空,UI的Validation 机制将会接管前台验证错误显示,然后台,则会忽略该点击事件操做。若是你想获取跟为详细的验证错误信息提示,能够经过Validation类中的 GetErrors()方法枚举出全部被捕获的验证错误信息。
List
<
ValidationError
>
errors
=
new
List
<
ValidationError
>
();
foreach
(ValidationError erroritem
in
Validation.GetErrors(txtUserName))
{
errors.Add(erroritem);
}

最终注册提交代码以下:
private
void
btReg_Click(
object
sender, RoutedEventArgs e)
{
BindingExpression beUsername
=
txtUserName.GetBindingExpression(TextBox.TextProperty);
beUsername.UpdateSource();
BindingExpression bePassword
=
txtPassword.GetBindingExpression(TextBox.TextProperty);
bePassword.UpdateSource();
BindingExpression beAge
=
txtAge.GetBindingExpression(TextBox.TextProperty);
beAge.UpdateSource();
if
(Validation.GetHasError(txtUserName))
return
;
if
(Validation.GetHasError(txtPassword))
return
;
if
(Validation.GetHasError(txtAge))
return
;
//
捕获验证错误集合演示
List
<
ValidationError
>
errors
=
new
List
<
ValidationError
>
();
foreach
(ValidationError erroritem
in
Validation.GetErrors(txtUserName))
{
errors.Add(erroritem);
}
}
其结果,点击“注册”按钮,则会提示验证错误,修改内容后,再次点击“注册”按钮,验证经过后,进入注册流程。
最后须要说明一点,这种验证方法,和验证机制是无关的,不管使用哪种验证机制,均可以使用该方法,进行用户交互数据验证。今天就介绍到这里,但愿对你们有所帮助。
源代码下载