Enterprise Library 3.0体验（4）：Validation Application Block与ASP.NET的集成

摘要：也许大家都已经习惯了使用ASP.NET中的验证控件进行数据有效性的验证，但是验证控件的验证无法与我们的自定义的实体类结合起来，两者属于不同层面的验证。在Enterprise Library 3.0中有了Validation Application Block，可以轻松的实现页面验证与类验证的结合。

 

1．编写实体类，本文我使用Enterprise Library 3.0 QuickStarts中的例子，采用Atteribute验证的方式（采用配置文件来实现也是一样的），分别设置验证规则集合、错误信息提示等属性，代码如下：

public   class  Customer
{
    private string firstName;
    private string lastName;
    private DateTime dateOfBirth;
    private string email;
    private int rewardPoints;

    [StringLengthValidator(1, 50, Ruleset = "RuleSetA", MessageTemplate="First Name must be between 1 and 50 characters long")]
    public string FirstName
    {
        get { return firstName; }
        set { firstName = value; }
    }

    [StringLengthValidator(1, 50, Ruleset = "RuleSetA", MessageTemplate = "Last Name must be between 1 and 50 characters long")]
    public string LastName
    {
        get { return lastName; }
        set { lastName = value; }
    }

    [RelativeDateTimeValidator(-120, DateTimeUnit.Year, -18, DateTimeUnit.Year, Ruleset = "RuleSetA", MessageTemplate="Must be 18 years old")]
    public DateTime DateOfBirth
    {
        get { return dateOfBirth; }
        set { dateOfBirth = value; }
    }

    [RegexValidator(@"\w+([-+.']\w+)*@\w+([-.]\w+)*\.\w+([-.]\w+)*", Ruleset = "RuleSetA")]
    public string Email
    {
        get { return email; }
        set { email = value; }
    }

    [Int32RangeValidator(0, 1000000, Ruleset = "RuleSetA", MessageTemplate = "Rewards points cannot exceed 1,000,000")]
    public int RewardPoints
    {
        get { return rewardPoints; }
        set { rewardPoints = value; }
    }
}

2．添加PropertyProxyValidator控件。在工具箱中添加新项，选择Microsoft.Practices.EnterpriseLibrary.Validation.Integration.AspNet，默认的安装路径为C:\Program Files\Microsoft Enterprise Library 3.0 - January 2007 CTP\Bin，添加完成后可以在工具箱中看到PropertyProxyValidator控件。

3．编写ASPX页面，如下图所示：

代码如下：

< div >
     < h3 >
        Validation Application Block: ASP.NET Integration QuickStart </ h3 >
    
         < table >
             < tr >
                 < td  style ="width: 100px" >
                    First Name: </ td >
                 < td  style ="width: 508px" >
                     < asp:TextBox  ID ="firstNameTextBox"  runat ="server"  Width ="235px" ></ asp:TextBox > &nbsp;
                     < br  />
                 </ td >
             </ tr >
             < tr >
                 < td  style ="width: 100px; height: 21px" >
                    Last Name: </ td >
                 < td  style ="width: 508px; height: 21px" >
                     < asp:TextBox  ID ="lastNameTextBox"  runat ="server"  Width ="235px" ></ asp:TextBox >< br  />
                     </ td >
             </ tr >
             < tr >
                 < td  style ="width: 100px" >
                    Date Of Birth: </ td >
                 < td  style ="width: 508px" >
                     < asp:TextBox  ID ="dateOfBirthTextBox"  runat ="server" ></ asp:TextBox >< br  />
                     </ td >
             </ tr >
             < tr >
                 < td  style ="width: 100px" >
                    E-mail: </ td >
                 < td  style ="width: 508px" >
                     < asp:TextBox  ID ="emailTextBox"  runat ="server"  Width ="235px" ></ asp:TextBox >< br  />
                     </ td >
             </ tr >
             < tr >
                 < td  style ="width: 100px; height: 25px;" >
                    Rewards Points: </ td >
                 < td  style ="width: 508px; height: 25px;" >
                     < asp:TextBox  ID ="rewardsPointsTextBox"  runat ="server" ></ asp:TextBox >< br  />
                     </ td >
             </ tr >
             < tr >
                 < td  style ="width: 100px" >
                 </ td >
                 < td  style ="width: 508px" >
                     < asp:Button  ID ="submitButton"  runat ="server"  Text ="Submit"  OnClick ="submitButton_Click"   /> &nbsp;
                     < asp:Label  ID ="validationResultsLabel"  runat ="server" ></ asp:Label ></ td >
             </ tr >
         </ table >
</ div >

4．在页面上需要验证的地方添加PropertyProxyValidator控件，基本的属性设置如下：

< cc1:propertyproxyvalidator  id ="firstNameValidator"  runat ="server"  

    ControlToValidate ="ContolToValidate"  

    PropertyName ="PropertyName"  

    RulesetName ="RuleSetName"  

    SourceTypeName ="ValidationAspNetQuickStart.Customer" >

</ cc1:propertyproxyvalidator >

其中ControlToValidate指定对应的需要验证的控件ID，PropertyName指定在实体类中的属性名，RulesetName指定验证规则的名称，SourceTypeName指定实体类型名，当然了你也可以像验证控件一样通过Display属性来指定验证信息的显示方式：None、Static、Dynamic。PropertyProxyValidator还有一个很重要的事件OnValueConvert，在事件可以通过做类型转换根据是否抛出异常来判断输入是否正确，以及设置验证提示信息等。添加完PropertyProxyValidator后代码如下：

< div >
     < h1 >
        Validation Application Block: ASP.NET Integration QuickStart </ h1 >
    
         < table >
             < tr >
                 < td  style ="width: 100px" >
                    First Name: </ td >
                 < td  style ="width: 508px" >
                     < asp:TextBox  ID ="firstNameTextBox"  runat ="server"  Width ="235px" ></ asp:TextBox > &nbsp;
                     < br  />
                 < cc1:propertyproxyvalidator  id ="firstNameValidator"  runat ="server"  
                    ControlToValidate ="firstN
                    ameTextBox"  
                    PropertyName ="FirstName"  
                    RulesetName ="RuleSetA"  
                    SourceTypeName ="ValidationAspNetQuickStart.Customer" >
                 </ cc1:propertyproxyvalidator >
                 </ td >
             </ tr >
             < tr >
                 < td  style ="width: 100px; height: 21px" >
                    Last Name: </ td >
                 < td  style ="width: 508px; height: 21px" >
                     < asp:TextBox  ID ="lastNameTextBox"  runat ="server"  Width ="235px" ></ asp:TextBox >< br  />
                     < cc1:PropertyProxyValidator  ID ="lastNameValidator"  runat ="server"  ControlToValidate ="lastNameTextBox"
                        PropertyName ="LastName"  RulesetName ="RuleSetA"  SourceTypeName ="ValidationAspNetQuickStart.Customer" ></ cc1:PropertyProxyValidator ></ td >
             </ tr >
             < tr >
                 < td  style ="width: 100px" >
                    Date Of Birth: </ td >
                 < td  style ="width: 508px" >
                     < asp:TextBox  ID ="dateOfBirthTextBox"  runat ="server" ></ asp:TextBox >< br  />
                     < cc1:PropertyProxyValidator  ID ="dateOfBirthValidator"  runat ="server"  ControlToValidate ="dateOfBirthTextBox"
                        OnValueConvert ="dateOfBirthValidator_ValueConvert"  PropertyName ="DateOfBirth"
                        RulesetName ="RuleSetA"  SourceTypeName ="ValidationAspNetQuickStart.Customer" ></ cc1:PropertyProxyValidator ></ td >
             </ tr >
             < tr >
                 < td  style ="width: 100px" >
                    E-mail: </ td >
                 < td  style ="width: 508px" >
                     < asp:TextBox  ID ="emailTextBox"  runat ="server"  Width ="235px" ></ asp:TextBox >< br  />
                     < cc1:PropertyProxyValidator  ID ="emailValidator"  runat ="server"  ControlToValidate ="emailTextBox"
                        PropertyName ="Email"  RulesetName ="RuleSetA"  SourceTypeName ="ValidationAspNetQuickStart.Customer" ></ cc1:PropertyProxyValidator ></ td >
             </ tr >
             < tr >
                 < td  style ="width: 100px; height: 25px;" >
                    Rewards Points: </ td >
                 < td  style ="width: 508px; height: 25px;" >
                     < asp:TextBox  ID ="rewardsPointsTextBox"  runat ="server" ></ asp:TextBox >< br  />
                     < cc1:PropertyProxyValidator  ID ="rewardPointsValidator"  runat ="server"  ControlToValidate ="rewardsPointsTextBox"
                         PropertyName ="RewardPoints"
                        RulesetName ="RuleSetA"  SourceTypeName ="ValidationAspNetQuickStart.Customer"  OnValueConvert ="rewardsPointsValidator_ValueConvert" ></ cc1:PropertyProxyValidator ></ td >
             </ tr >
             < tr >
                 < td  style ="width: 100px" >
                 </ td >
                 < td  style ="width: 508px" >
                     < asp:Button  ID ="submitButton"  runat ="server"  Text ="Submit"  OnClick ="submitButton_Click"   /> &nbsp;
                     < asp:Label  ID ="validationResultsLabel"  runat ="server" ></ asp:Label ></ td >
             </ tr >
         </ table >
</ div >

5．在这里有两个验证器用到了OnValueConvert事件，对应的CS代码如下：

protected   void  rewardsPointsValidator_ValueConvert( object  sender, Microsoft.Practices.EnterpriseLibrary.Validation.Integration.AspNet.ValueConvertEventArgs e)
{
    string value = e.ValueToConvert as string;
    try
    {
        e.ConvertedValue = Int32.Parse(value);
    }
    catch
    {
        e.ConversionErrorMessage = "Rewards points is not a valid integer";
        e.ConvertedValue = null;
    }
}

protected   void  dateOfBirthValidator_ValueConvert( object  sender, Microsoft.Practices.EnterpriseLibrary.Validation.Integration.AspNet.ValueConvertEventArgs e)
{
    string value = e.ValueToConvert as string;
    try
    {
        e.ConvertedValue = DateTime.Parse(value, System.Globalization.CultureInfo.CurrentCulture);
    }
    catch
    {
        e.ConversionErrorMessage = "Date Of Birth is not in the correct format.";
        e.ConvertedValue = null;
    }
}

6．运行后，输入错误的数据如下图所示：

关于Validation Application Block与ASP.NET的集成就简单得介绍到这儿。

注意本文使用的版本是Enterprise Library 3.0 January 2007 CTP版本。