本文演示Enterprise Library – Validation Application Block 验证管理模块的使用。总共有13个练习,前面11个练习在Windows Form应用程序处理用户输入的数据,赋值给Customer和Address业务对象。Validation Application Block用来在处理数据之前,验证创建的业务对象。第12个练习演示如何使用Validation Application Block集成ASP.NET验证特性,验证ASP.NET控件值。在第13个练习中,APS.NET Application 作为Windows Communication Foundation(WCF)服务前端,利用Validation Application Block集成WCF验证特性,在Server端验证服务参数。本文由http://blog.entlib.com 开源ASP.NET博客平台小组根据EntLib HOL手册编译提供,欢迎交流。
练习一:添加验证
本文练习对业务对象实施验证操作,和对一个简单的数据录入应用程序使用using 属性指定验证规则(Validation Rule)。
1. 首先打开\Enterprise Library 4.1 HOL\CS\Validation\Labs\Lab01\Before目录下的ValidationHOL.sln项目文件。该Solution包含有两个项目,分别为ValidationHOL.BusinessLogic和ValidationHOL。
因为现在还没有对ValidationHOL项目做任何更改,在运行范例程序,点击Accept按钮时,没有执行任何验证操作,应用程序则试图处理无效的数据。
本文主要包含如下内容:
(1)添加验证属性到业务类中;
(2)对业务对象实例调用验证规则;
针对特定类型的验证不会自动执行,需要在Client端显式调用。
2. 为ValidationHOL.BusinessLogic 项目添加Microsoft.Practices.EnterpriseLibrary.Validation.dll 程序集的引用。
打开ValidationHOL.BusinessLogic 项目中Customer.cs文件,添加对Validation 命名空间的引用。
using Microsoft.Practices.EnterpriseLibrary.Validation.Validators;
3. 为Customer类的属性添加validation特征。
public class Customer
{
[StringLengthValidator(1, 25)]
public string FirstName { get; set; }
[StringLengthValidator(1, 25)]
public string LastName { get; set; }
[RegexValidator(@"^\d\d\d-\d\d-\d\d\d\d$")]
public string SSN { get; set; }
public Address Address { get; set; }
}
4. 为Address类的属性添加validation特征。
打开Address.cs文件,添加如下命名空间的引用。
using Microsoft.Practices.EnterpriseLibrary.Validation;
using Microsoft.Practices.EnterpriseLibrary.Validation.Validators;
进一步修改Address类,如下所示;
public class Address
{
[StringLengthValidator(1, 50)]
public string StreetAddress { get; set; }
[ValidatorComposition(CompositionType.And)]
[StringLengthValidator(1, 30)]
[ContainsCharactersValidator("sea", ContainsCharacters.All)]
public string City { get; set; }
[StringLengthValidator(2, 2)]
public string State { get; set; }
[RegexValidator(@"^\d{5}$")]
public string ZipCode { get; set; }
}
上述代码中,针对City属性定义了多个validation attributes。当针对某一个类的属性定义多个validation attributes时,需要创建一个组合的验证特性(composite validator),设置为多个validation attributes之间是and或or 的关系。当为and时,需要所有的validation attributes验证通过时,才验证通过。如果为or时,则只需要一个validation attribute符合,就验证通过。ContainsCharactersValidator 要求City属性中必须同时包含有s、e、a三个字符。
5. 下面针对业务对象实例调用验证
Validation必须通过代码显式调用,除非一些特殊的机制,如Policy Injection Application Block,可以用来截取方法调用。
调用验证的结果是生成一个ValidationResults实例,该实例表示验证是否成功。如果没有成功,则包含每一个验证规则失败的ValidationResult实例集合。
(1)为ValidationHOL项目添加对Microsoft.Practices.EnterpriseLibrary.Validation.dll程序集的引用。
(2)打开MainForm.cs文件,添加如下命名空间的引用。
using Microsoft.Practices.EnterpriseLibrary.Validation;
(3)更新MainForm类的acceptButton_Click方法,调用validation,如验证失败,则显示一个错误消息。
下面运行范例程序,检查验证规则是否生效。
首先,文本框不输入任何内容,点击Accept按钮,将弹出一个错误信息窗口,如下图所示。
继续按照验证规则的要求,输入正确的Customer数据,点击Accept按钮,检查是否通过验证规则。
http://www.entlib.com专业ASP.NET电子商务平台小组,欢迎你继续访问Validation Application Block学习手册。
参考文档:
Validation Application Block Hands-On Labs for Enterprise Library