Click here to Skip to main content
15,867,453 members
Articles / Web Development / HTML

Multiple Fields Validator - An ASP.NET Validation Control

Rate me:
Please Sign up or sign in to vote.
4.95/5 (98 votes)
7 Apr 2006Ms-PL4 min read 768.9K   5.5K   134   184
Discussing the MultipleFieldsValidator that validates a group of fields in which at least one is required, like phone number, mobile phone number, or email. It inherits the BaseValidator and uses some new cool ASP.NET 2.0 features.

Sample Image

Introduction

In an ideal world, web users don't need to authenticate because they are trustworthy, no try-catch because there wouldn't be any bug or unexpected behavior, and you wouldn't be using web validators because users will be submitting valid entries. But since we are not living in that world, I hope we would some time, you might find this validator useful, so bear with me.

Developing with ASP.NET, I've encountered many cases when you only need one field to be filled out of many given fields. To validate in such cases, I used to have a custom validator, or a client-script, or sometimes did server-side validation only.

The problem with a custom validator, and all other ASP.NET validators, is that they are mainly designed to handle one or two fields. Also, you need to write custom server-side and client-side code, or maybe copy and paste code, every time you encounter validating multiple fields. To solve this, I have made this light multiple-controls validator, and got use of the new ASP.NET 2.0 features.

Background

Even with ASP.NET 2.0, a lot of valuable validation controls are missing, especially those for multiple-fields validation. Peter Blum has created a set of commercial controls called Professional Validation And More to fill this gap and he, when answering my forum post, gave me the idea of implementing my own validator.

I have also found a good article on CodeProject by Daniel Hacquebord on CustomValidator dependent on multiple controls that addresses a similar need, however, this validation control has the following advantages:

  1. Doesn't require writing any client or server-side code. Just drop it on the page and assign it the controls that you want to validate.
  2. HTML/XHTML compatible. It assigns additional attributes with JavaScript rather than adding them directly to the span tag. That is, it uses JavaScript document["MyMultipleFieldsValidator"].condition = "OR" rather than the HTML <span id="MyMultipleFieldsValidator" condition = "OR">.
  3. Uses a .js resource file to register the client-side code rather than writing the client-side code in every page that requires this control.
  4. Inherits directly from BaseValidator versus CusomValidator, thus, gaining a tiny extra performance.

There is another good article on CodeProject that gave me some inspiration, called RequiredIfValidator - Extending from the BaseValidator class about a validator that validates another field based on the selection of a drop down list.

Using the Code

BaseValidator, the base of this control, is mainly made to handle one control so I had to disable some properties that is meant to validate a single control. I had to shadow the ControlToValidate and SetFocusOnError properties and hide them from the designer and the Visual Studio editor.

C#
[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.");
    }
}

In the AddAttributesToRender, I am using the ASP.NET 2.0 RegisterExpandoAttribute method to add attributes, using JavaScript, to the <span> tag generated by the validator rather than adding them statically, hence, keeping it HTML/XHTML friendly.

C#
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));
}

In the OnPreRender, I've used the new ASP.NET 2.0 method RegisterClientScriptResource to add my embedded .js file to the page. There is a good article by Gary Dryden on CodeProject called WebResource ASP.NET 2.0 explained that deals with this subject.

C#
protected override void OnPreRender(EventArgs e) {
    base.OnPreRender(e);
    if (base.RenderUplevel) {
        this.Page.ClientScript.RegisterClientScriptResource(
            typeof(MultipleFieldsValidator),
            "AdamTibi.Web.UI.Validators.WebUIValidationExtended.js");
    }
}

Using the Validator

To use this validator from your Visual Studio IDE, you need to add the provided .dll to the toolbox. For more information on this, check the MSDN documentation.

After dropping the validator on a webform, all you need to do is to set the ControlsToValidate property, from the Properties window, to point to the controls that you want to validate. This summarizes the generated code; however, the demo attached with the article has more examples.

The Condition property, which is set to OR by default, sets the condition that you want to apply when validating multiple fields. So, OR ensures one of the fields is filled, XOR ensures one of the fields is filled but not all of them.

ASP.NET
<%@ Page Language="C#" AutoEventWireup="true" %>
<%@ Register TagPrefix="atv" Namespace="AdamTibi.Web.UI.Validators" 
    Assembly="AdamTibi.Web.UI.Validators" %>
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 
"http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
    <title></title>
</head>
<body>
<form id="form1" runat="server">
<asp:TextBox ID="txtPhone" runat="server"></asp:TextBox>
<asp:TextBox ID="txtMobile" runat="server"></asp:TextBox>
<asp:TextBox ID="txtEmail" runat="server"></asp:TextBox>
<atv:MultipleFieldsValidator ID="mfv" runat="server" Condition="OR"
    ControlsToValidate="txtPhone,txtMobile,txtEmail">
    fill at least one field</atv:MultipleFieldsValidator>
</form>
</body>
</html>

Limitations

I've only tested the validator on Internet Explorer 6 and Firefox 1.5; however, I am not using any weird JavaScript so it should work on other browsers as well. Please let me know if it worked for you.

I only need the validator to check TextBox fields so I didn't check it with other types of controls; however, in theory, it should work fine. Also, let me know if you are getting any problems.

Conclusion

I hope I made someone’s day. If you like this article, then please remember to vote. If you have any suggestions, bugs, or enhancements, then hit me with it!

History

  • 10th March, 2006 - First version
  • 4th April, 2006 - Now works with Firefox

License

This article, along with any associated source code and files, is licensed under The Microsoft Public License (Ms-PL)


Written By
Architect
United Kingdom United Kingdom
Passionate about refining software practices, promoting self-motivated teams and orchestrating agile projects.
Lives in London, UK and works as a .NET architect consultant in the City.

Blog AdamTibi.net.

Comments and Discussions

 
AnswerRe: help... Pin
Adam Tibi24-Sep-08 8:12
professionalAdam Tibi24-Sep-08 8:12 
GeneralNice work and a huge help! Pin
Stevishere9-Sep-08 11:58
Stevishere9-Sep-08 11:58 
GeneralRe: Nice work and a huge help! Pin
Adam Tibi9-Sep-08 23:50
professionalAdam Tibi9-Sep-08 23:50 
GeneralThanks a lot Pin
blue_nerve26-Aug-08 20:03
blue_nerve26-Aug-08 20:03 
GeneralRe: Thanks a lot Pin
Adam Tibi26-Aug-08 22:49
professionalAdam Tibi26-Aug-08 22:49 
QuestioncheckBox control not validating Pin
ag.rinku29-Jul-08 6:26
ag.rinku29-Jul-08 6:26 
AnswerRe: checkBox control not validating Pin
Adam Tibi29-Jul-08 23:01
professionalAdam Tibi29-Jul-08 23:01 
GeneralRe: checkBox control not validating Pin
ag.rinku30-Jul-08 1:39
ag.rinku30-Jul-08 1:39 
I am posting at correct article.Thanks a lot.Both the code have helped me a lot and I have combined the above two to fit my req.

Thanks again adam.
GeneralVisibility Pin
stribbed7-Jul-08 16:46
stribbed7-Jul-08 16:46 
GeneralRe: Visibility Pin
Adam Tibi8-Jul-08 2:32
professionalAdam Tibi8-Jul-08 2:32 
GeneralRe: Visibility Pin
stribbed8-Jul-08 15:29
stribbed8-Jul-08 15:29 
GeneralValidatorCalloutExtender Pin
Member 374192122-Jun-08 23:38
Member 374192122-Jun-08 23:38 
GeneralRe: ValidatorCalloutExtender Pin
Adam Tibi25-Jun-08 2:57
professionalAdam Tibi25-Jun-08 2:57 
GeneralExcellent! Pin
jonathan.ownbey21-Mar-08 6:47
jonathan.ownbey21-Mar-08 6:47 
GeneralRe: Excellent! Pin
Adam Tibi23-Mar-08 23:41
professionalAdam Tibi23-Mar-08 23:41 
GeneralRe: Excellent! Pin
fritzfox6-Apr-08 14:18
fritzfox6-Apr-08 14:18 
GeneralRe: Excellent! Pin
Adam Tibi6-Apr-08 21:59
professionalAdam Tibi6-Apr-08 21:59 
Generalhi Pin
James DC27-Feb-08 22:53
James DC27-Feb-08 22:53 
GeneralRe: hi Pin
Adam Tibi1-Mar-08 23:11
professionalAdam Tibi1-Mar-08 23:11 
GeneralRe: hi Pin
blackbart3-Mar-08 8:00
professionalblackbart3-Mar-08 8:00 
QuestionXOR does not appear to work with more than two fields Pin
blackbart27-Feb-08 10:23
professionalblackbart27-Feb-08 10:23 
GeneralRe: XOR does not appear to work with more than two fields Pin
Adam Tibi27-Feb-08 23:03
professionalAdam Tibi27-Feb-08 23:03 
GeneralRe: XOR does not appear to work with more than two fields Pin
blackbart28-Feb-08 7:43
professionalblackbart28-Feb-08 7:43 
GeneralRe: XOR does not appear to work with more than two fields Pin
Adam Tibi1-Mar-08 23:07
professionalAdam Tibi1-Mar-08 23:07 
GeneralRe: XOR does not appear to work with more than two fields Pin
blackbart3-Mar-08 7:42
professionalblackbart3-Mar-08 7:42 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.