【翻译】多域校验控件——基于ASP.NET的验证控件[Carol]-CSDN博客

多域校验控件——基于ASP.NET的验证控件

原文地址：http://www.codeproject.com/aspnet/MultipleFieldsValidator.asp

作者：Adam Tibi 翻译: Carol

我们探讨的是多域的校验，是指校验一组域，其中至少有一个域是必须被检验的，如电话号码，手机号或者电子邮件。它继承自BaseValidator并且使用了一些又新又炫的ASP.NET2.0特性。

导言

在理想世界中，网页使用者无需认证，因为他们是值得信赖的，那里将不会有千年虫或者任何不可预期的行为，所以也不用try-catch。使用者将提交有效的输入，因此你也无需使用网页校验。但是既然我们不是生活在那样的世界中，我希望一段时间后你们会发现这种校验是有用的。

在ASP.NET开发过程中，我遇到过许多案例：在许多备选域中你只需填充一个域。在这些域中进行校验，我曾习惯于用自定义校验，或者客户端脚本，或者有时只用服务器端验证。

使用自定义校验以及所有其他ASP.NET校验的问题在于：它们主要用于处理一个或两个域，而且每次遇到校验多个域时，你都需要写自定义的服务器端或客户服务器端代码，或者也许就是复制和粘贴代码。为了解决这一问题，我制作了这个轻量级的多控件的校验控件，并且使用了新的ASP.NET 2.0特性。

背景

即使使用ASP.NET 2.0，许多珍贵的校验控件都在丢失，尤其是那些用于多域的校验。Peter Blum创造了一套叫做Professional Validation And More（专业校验及更多）的商业控件来填补这一缺口。他在回答我的论坛的帖子时，给了我实践自己的校验控件的想法。

在CodeProject上我也发现了一些由Daniel Hacquebord著的关于CustomValidator dependent on multiple controls（基于多控件的定制校验控件）的好文章。它提出了一种同样的需要。这种校验控件具备以下几个优势：

1．不需要写任何客户端或服务端代码。只需将它拖到页面上然后指定你想校验的控件。

2． HTML/XHTML兼容。它用JavaScript指定附加属性，而不是将附加属性直接添加到span标签。也就是说，它使用JavaScript

document["MyMultipleFieldsValidator"].condition = "OR"

而不是 HTML <span id="MyMultipleFieldsValidator" condition = "OR">.

3．使用.js资源档案来注册客户端代码，而不用在每一张需要这一控件的页面上写客户代码。

4．直接从BaseValidator继承下来，相对于从 CusomValidator继承得到了一些细小的额外特性

在CodeProject上还有一篇好文章给了我一些启示，文章的题目是RequiredIfValidator - Extending from the BaseValidator class，是关于一种校验控件，用于校验基于下拉列表选择的另一个项。

使用代码

这个控件基于的BaseValidator，主要用于处理一个控件，所以我不得不禁用一些旨在校验一个单独控件的属性。我得把ControlToValidate 和SetFocusOnError属性覆盖，并把它们从设计者及Visual Studio编辑者那隐藏起来。

[Browsable( false )]

[EditorBrowsable(EditorBrowsableState.Never)]

public new bool SetFocusOnError {

get {

return false ;

}

set {

throw new NotSupportedException( " SetFocusOnError is not supported. " );

}

}

[Browsable( false )]

[EditorBrowsable(EditorBrowsableState.Never)]

public new string ControlToValidate {

get {

return string .Empty;

}

set {

throw new NotSupportedException( " ControlToValidate is not supported. " );

}

}

在AddAttributesToRender方法中我使用ASP.net 2.0提供的RegisterExpandoAttribute方法动态的将调用JavaScript的语句添加到由validator生成的<span>标签中而不是静态的写入页面这样可以保持HTML/XHTML代码的友好度

if ( this .RenderUplevel) {

string clientID = this .ClientID;

Page.ClientScript.RegisterExpandoAttribute(clientID,

" evaluationfunction " ,

" MultipleFieldsValidatorEvaluateIsValid " );

Page.ClientScript.RegisterExpandoAttribute(clientID,

" controlstovalidate " ,

this .GenerateClientSideControlsToValidate());

Page.ClientScript.RegisterExpandoAttribute(clientID,

" condition " ,

PropertyConverter.EnumToString( typeof (Conditions), Condition));

}

在OnPreRender，我已经使用了新的ASP.NET 2.0方法：RegisterClientScriptResource，用以将我的嵌入的.js档案添加到页面。在CodeProject 上有一篇名为WebResource ASP.NET 2.0 explained的好文章是用于处理这一问题的，其作者是Gary Dryden。

protected override void OnPreRender(EventArgs e) {

base .OnPreRender(e);

if ( base .RenderUplevel) {

this .Page.ClientScript.RegisterClientScriptResource(

typeof (MultipleFieldsValidator),

" AdamTibi.Web.UI.Validators.WebUIValidationExtended.js " );

}

}

使用校验控件

要从你的Visual Studio IDE中使用这一校验，你需要把提供的.dll添加到工具箱。关于这一点更多的信息，请点击MSDN documentation。

在web form 上拖一个校验控件之后，你所需做的只要设置ControlsToValidate属性，在属性窗口上指出你想校验的控件。本文附带的演示有更多的例子。

默认状态下会被设置为OR的Condition属性设定了你校验多域时所要运用的条件。因此，OR确保其中一个域是需要被填写的，而XOR确保其中之一被检验而不是全部。