Click here to Skip to main content
15,867,568 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

 
QuestionPermission denied error issues Pin
Fandango6829-Oct-14 15:27
Fandango6829-Oct-14 15:27 
AnswerRe: Permission denied error issues Pin
Fandango6829-Oct-14 18:56
Fandango6829-Oct-14 18:56 
GeneralRe: Permission denied error issues Pin
Adam Tibi31-Oct-14 0:37
professionalAdam Tibi31-Oct-14 0:37 
Question.NET 4.0 compatibility Pin
Gianpiero Caretti29-Aug-12 6:13
Gianpiero Caretti29-Aug-12 6:13 
NewsGreat Job! Pin
Jani Giannoudis16-Apr-12 18:31
Jani Giannoudis16-Apr-12 18:31 
GeneralMy vote of 5 Pin
member6029-Nov-11 23:39
member6029-Nov-11 23:39 
QuestionWhat About a check box and a text box? Pin
metapro6-Jun-11 5:46
metapro6-Jun-11 5:46 
GeneralValidateEmptyText property a possibility? Pin
CWells127-Apr-11 12:23
CWells127-Apr-11 12:23 
GeneralMy vote of 5 Pin
CWells127-Apr-11 12:21
CWells127-Apr-11 12:21 
GeneralMy vote of 5 Pin
Member 412980623-Feb-11 3:27
Member 412980623-Feb-11 3:27 
GeneralRevalidate on key press Pin
dazipe17-Feb-11 21:11
dazipe17-Feb-11 21:11 
GeneralMultiple RadComboBox validation :S Pin
Member 225598810-Aug-10 12:43
Member 225598810-Aug-10 12:43 
GeneralChange c# to vb.net Pin
Gensy Chong25-Jul-10 23:32
Gensy Chong25-Jul-10 23:32 
Jokehelpful.... Pin
leopard-saleh1-Mar-10 9:28
leopard-saleh1-Mar-10 9:28 
GeneralRe: helpful.... Pin
Adam Tibi2-Mar-10 0:13
professionalAdam Tibi2-Mar-10 0:13 
Questionit is not validating properly Pin
Sreedhar Mallipedda10-Feb-10 5:23
Sreedhar Mallipedda10-Feb-10 5:23 
GeneralNice Work! Pin
Joshua Blackstone1-Feb-10 4:43
Joshua Blackstone1-Feb-10 4:43 
GeneralThank you Pin
simonmharris27-Jan-10 21:30
simonmharris27-Jan-10 21:30 
GeneralRe: Thank you Pin
Adam Tibi31-Jan-10 23:16
professionalAdam Tibi31-Jan-10 23:16 
GeneralJust what I needed Pin
jmar215-Dec-09 10:07
jmar215-Dec-09 10:07 
GeneralNice work - re-validate on loss of focus. Pin
Colin Breame24-Nov-09 18:18
Colin Breame24-Nov-09 18:18 
GeneralRe: Nice work - re-validate on loss of focus. Pin
Adam Tibi26-Nov-09 1:06
professionalAdam Tibi26-Nov-09 1:06 
GeneralCHANGE TO ONPRERENDER METHOD FOR FRAMEWORK 3.5 Pin
JacquiF20-Nov-09 2:51
JacquiF20-Nov-09 2:51 
Firstly Adam - fabulous validator! Smile | :)

I kept on getting an object undefined error on MultipleFieldsValidatorEvaluateIsValid on 3.5, but tweaked the OnPreRender to look like the following and it works just greate:

If Not Me.Page.ClientScript.IsClientScriptIncludeRegistered(Me.GetType(), "CustomValidators") Then
Me.Page.ClientScript.RegisterClientScriptInclude(Me.GetType(), "CustomValidators", Me.Page.ClientScript.GetWebResourceUrl(Me.GetType(), "CustomValidators.MultipleFieldUIValidators.js"))
End If
GeneralRe: CHANGE TO ONPRERENDER METHOD FOR FRAMEWORK 3.5 Pin
Adam Tibi26-Nov-09 1:08
professionalAdam Tibi26-Nov-09 1:08 
QuestionInitialValue Pin
grenadier1-Sep-09 9:47
grenadier1-Sep-09 9:47 

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.