Server Side Validation Library

by Chad Finsterwald

This code sample applies to ASP.NET for the .NET 2.0 framework. Examples are written in C#.

The Problem
The Approach
Server Side Validation Library Overview
Example One
Example Two
Conclusion

The Problem:

In my coding I've shied away from using the Validation Controls as I've found them to fall prey to that most ubitiquous of all rules: The 80/20 Rule. For the 80% of cases like validating a "First Name" field, they work great. Clients love the coolness factor of the immediate feedback and the code required to use them is minimal. When it comes to the other 20% of cases, like when I need to ensure that the value entered for an accout is less than $10,000 if the client is using "Student Checking" and has had the account for less than 3 years, it is a different story. These cases often require writing complex javascript, adopting a hybrid client-side/server-side approach, or dropping client-side validation altogether. Since the 20% case will occur 100% of the time, I view server side validation as a better approach except in those (few) instances where avoiding a roundtrip to the server is REALLY important.

The Approach:

This article will introduce you to a server side validation library. The objectives of the library are to:

Provide a uniform and extensible approach for even complex validation scenarios.
Reduce the amount of code required for user input validation.
Create a consistent user experience with both visual and textual feedback regarding specific user input errors.
Centralize page-level user validation so that it is easier to maintain and comprehend.

Server Side Validation Library Overview

Class Digram
Figure 1: Class Diagram

A note for those familar with the CSLA framework by Rockford Lhotka, you will notice the similarity regarding the "BrokenRules" name. This is about the only similarity between what is offerred here and Lhotka's framework. I did read and enjoy Lhotka's Expert C# 2005 Business Objects, so perhaps like Kaavya Viswanathan I was unconsciously influenced in my choice of class names...

Below is a simple description of each of the main classes and their role in the library --it is not meant to be exhaustive, but simply to give a quick overview.

BrokenRules and BrokenWebRules: These are principal classes in the library. BrokenWebRules in particular forms the backbone of the library as it contains the methods you will use to evaluate certain rules --e.g., Required, Assert, AssertPattern, etc.

BrokenRule: A Struct containing information about a particular validation rule.

StyleItem, ClassStyle, and InlineStyle: Information about the particular style to apply to invalid (or valid) controls. The BrokenWebRules uses the Strategy Pattern to determine how to change the style or class of a control.

StyleItemCollection: A collection to hold the various styles that should be applied to invalid (or valid) controls. This is used by the BrokenWebRule to apply the styles when a rule is called.

Example One

Sample Form Take the form to the right. In this cases we want to make sure that all the fields marked with an * are not empty. In addition, if the user selects "Other" from the drop down list as their favorite movie we want to ensure that they complete the textbox associated with that field.

Image 1: Sample Form

Sample Form If the user clicks submit without completing the required fields, the result is shown to the right. The invalid fields are displayed with a red border and the background is rendered light grey. The respective labels text is displayed in bold red. By hovering your mouse over either the label or field a tooltip is displayed indicating the reason the field is invalid.

Image 2: Sample Invalid Form

As the example code below will (I hope) show the application of the Server Side Validation Library is fairly straight forward. When the Submit button is clicked its event handler calls the ApplyRules method. This method in turn calls SetStyles which creates an instance of StyleItemCollection and various styles are assigned to the respective control types --by not passing in a Type to the AddInlineStyle method that style will apply to all HtmlControl and WebControl types. The StyleItemCollection is then returned back and passed into the newly created instance of BrokenWebRules. This informs BrokenWebRules of what styles to apply if a rule is invalid and to what control type. BrokenWebRules then successively applies each of the rules --e.g., the Required and Assert calls-- to the specified fields. Finally, whether or not any rule was broken is returned to the event handler which continues to process the event. (Click on the View Code header to follow the logic. Both the aspx and code behind are included.)

Click to View the Code

The Sample Form Aspx Page:

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>CoreWeb.Com</title>
    <link id="lnkCss" runat="server" rel="stylesheet" href="~/Base.css" />
</head>
<body>
    <form id="form1" runat="server">
    <div style="margin: 10px;">
      <h2>Sample Form</h2>
      <table>
         <tr>
            <td><asp:Label
               id="lblFirstName"
               runat="server"
               Text="First Name <span class='required'>*</span>" />
            </td>
            <td><asp:TextBox
               id="tbFirstName"
               runat="server" />
            </td>
         </tr>
         <tr>
            <td><asp:Label
               id="lblLastName"
               runat="server"
               Text="Last Name <span class='required'>*</span>" />
            </td>
            <td><asp:TextBox
               id="tbLastName"
               runat="server" />
            </td>
         </tr>
         <tr>
            <td><asp:Label
               id="lblFavoriteMovie"
               runat="server"
               Text="Favorite Movie <span class='required'>*</span>" />
            </td>
            <td>
               <asp:DropDownList
                  id="ddlFavoriteMovie"
                  runat="server">
                  <asp:ListItem Text="Space Mutiny" />
                  <asp:ListItem Text="Beaches" />
                  <asp:ListItem Text="Other" />
                  </asp:DropDownList>
               <asp:Label
                  id="lblFavoriteMovieOther"
                  runat="server"
                  Text="Other: " /> <asp:TextBox
               id="tbFavoriteMovie"
               runat="server" />
            </td>
         </tr>
         <tr>
            <td colspan="2" style="padding: 5px; text-align:right;" >
               <asp:Button 
                  id="btnSubmit"
                  runat="server"
                  Text="Submit" />
            </td>
         </tr>
      </table>
    </div>
    </form>
</body>
</html>

The Sample Form Aspx.CS Page:

using System;
using System.Data;
using System.Configuration;
using System.Collections;
using System.Web;
using System.Web.Security;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;
using System.Web.UI.HtmlControls;

using CoreWebLibrary.Validation.BrokenRules;

public partial class Demos_Article4_FormDemo : System.Web.UI.Page
{
   protected void Page_Load(object sender, EventArgs e)
   {
      RegisterEvents();
   }

   private void RegisterEvents()
   {
      btnSubmit.Click += new EventHandler(OnSubmitClick);
   }
   
   private BrokenRulesStyleCollection SetStyles()
   {
      //Set up the styles.  Likely this would be done 
      // in a BasePage or some other
      //central location.
      BrokenRulesStyleCollection brokenRulesStyles = 
         new BrokenRulesStyleCollection();
      
      //These styles will only apply to controls of 
      //Type System.Web.UI.WebControls.Label
      brokenRulesStyles.AddInlineStyle("color", "red", 
         lblFirstName.GetType());
      brokenRulesStyles.AddInlineStyle("font-weight", "bold", 
         lblFirstName.GetType());
      
      //These styles will only apply to controls of 
      // Type System.Web.UI.WebControls.TextBox 
      //or System.Web.UI.WebControls.DropDownList
      brokenRulesStyles.AddInlineStyle("border", "solid 1px red", 
         tbFirstName.GetType(), ddlFavoriteMovie.GetType());
      brokenRulesStyles.AddInlineStyle("background-color", "#eeeeee", 
         tbFirstName.GetType(), ddlFavoriteMovie.GetType());

      return brokenRulesStyles ;       
   }
   
   private bool ApplyRules()
   {
      //Pass in the style object to the BrokenWebRules 
      //class. This tells it how to modify the 
      //controls in the event that a rule is violated.
      BrokenWebRules brokenRules = new BrokenWebRules( SetStyles() );

      //Set up the various rules for the page.  
      // The second, (Name argument), must be 
      //unique.  It is how the rule is identified.
      brokenRules.Required(tbFirstName.Text, "First Name", 
         "First Name is required", lblFirstName, tbFirstName);
      brokenRules.Required(tbLastName.Text, "Last Name", 
         "Last Name is required", lblLastName, tbLastName);
      brokenRules.Required(ddlFavoriteMovie.SelectedItem.Text, 
         "Favorite Movie", "Favorite Movie is required", 
         lblFavoriteMovie, ddlFavoriteMovie);
      brokenRules.Assert(ddlFavoriteMovie.SelectedValue != "Other" || 
         tbFavoriteMovie.Text.Length > 0, 
         "Other Movie", 
         "You must include your favorite movie if Other was selected", 
         lblFavoriteMovieOther, tbFavoriteMovie);

      //Return if false is any rule was broken, true otherwise.
      return brokenRules.IsValid;
   }

   private void OnSubmitClick(object sender, EventArgs e)
   {
      //Check to make sure the form is valid
      bool isValid = ApplyRules();
      
      if ( isValid )
      {
         //The form is valid so do something
      }
      else
      {
         //The form is invalid so do something else
      }
   }
}

Example Two:

Example Two is a slight twist on the first example. In this case we are using classes defined in the applications linked CSS file to do the formatting and rather than just check to see if the "First Name" field is complete we are checking to ensure that it conforms to a Regular Expression pattern -- that First Name only contains alphabetical characters. To simplify the presentation, I've only included the SetStyles and ApplyRules method since that is the only part that changed.

Click to View the Code

The Sample Form Aspx Page:

 private BrokenRulesStyleCollection SetStyles()
   {
      //Set up the styles.  Likely this would be done in a 
      //BasePage or some other central location.
      BrokenRulesStyleCollection brokenRulesStyles = 
         new BrokenRulesStyleCollection();

      //This class will only apply to controls 
      //of Type System.Web.UI.WebControls.Label
      brokenRulesStyles.AddCssStyle("normalLabel", 
         "errorLabel", lblFirstName.GetType());

      //This class will only apply to controls of 
      //Type System.Web.UI.WebControls.TextBox or 
      //System.Web.UI.WebControls.DropDownList
      brokenRulesStyles.AddCssStyle("normalControl", "errorControl", 
         tbFirstName.GetType(), ddlFavoriteMovie.GetType());

      return brokenRulesStyles ;       
   }

   private bool ApplyRules()
   {
      BrokenWebRules brokenRules = 
         new BrokenWebRules(SetStyles());

      //checking for the pattern.
      brokenRules.AssertPattern("^[a-zA-Z]+$", tbFirstName.Text, 
         "First Name", 
         "First Name can only contain alphabetical characters", 
         lblFirstName, tbFirstName);
      brokenRules.Required(tbLastName.Text, "Last Name", 
         "Last Name is required", lblLastName, tbLastName);
      brokenRules.Required(ddlFavoriteMovie.SelectedItem.Text, 
         "Favorite Movie", "Favorite Movie is required", 
         lblFavoriteMovie, ddlFavoriteMovie);
      brokenRules.Assert(ddlFavoriteMovie.SelectedValue != "Other" || 
         tbFavoriteMovie.Text.Length > 0, "Other Movie", 
         "You must include your favorite movie if Other was selected",
         lblFavoriteMovieOther, tbFavoriteMovie);

      return brokenRules.IsValid;
   }

Conclusion

I hope that you found this helpful and that the BrokenRules Server Side Validation Library will simplify your validation needs. I look foward to your comments and if you extend the library, please send me what you've done.

Subject	Name	Date Submitted
Change page: 1 2 \| Displaying page 1 of 2, items 1 to 20 of 22.
Great Job Thanks for posting this. I HATE the client side validation controls, but never took the time to create a more generic server side framework. This will be a huge time saver for me! Reply View Thread	Dan	8/24/2006 4:53:34 PM
Best Now, we can use this with AJAX/ATLAS.... great Reply View Thread	Prajesh Jha	9/4/2006 4:35:51 AM
This is Cool! This library will save me tons of time. ASP.NET validation controls are good for very very basic stuff but never good enough for the kind of project i work on. Well done and Thank You! Reply View Thread	Jav	9/4/2006 5:36:38 AM
You forgot one thing... This library have one flaw that if your one job is to validate the data, it fails terribly. Maybe people should remember to check for BOTH null and empty strings... Reply View Thread	.NET God	9/7/2006 7:39:14 AM
You forgot one thing... If I understood your post correctly, I think your right. The Required method and the Assert Length checks should use String.IsNullOrEmpty(valueToCheck) and not just a length check. I will update the code accordingly and thanks for the feedback. Reply View Thread	Chad Finsterwald	9/7/2006 3:04:28 PM
Does it work with FormView and templates Like usua, they don't Reply View Thread	Ves	9/4/2006 8:30:13 AM
re: Does it work with FormView and templates I am not very familar with FormViews and so I have not tried to use it with that control. My hunch is that it would be easy to make this Server Side Library work with it and it is likley. When I have a chance I will try to make that fix and post the update article. In either case, thanks for your comment. Reply View Thread	Chad Finsterwald	9/4/2006 6:12:16 PM
There is one with client side There is one with client side http://codeproject.com/aspnet/highlight_validators.asp. Reply View Thread	klalex	9/4/2006 9:55:30 AM
Server validation Good idea Reply View Thread	wasim	9/4/2006 10:22:55 AM
Great Article This is a very good article. I really liked your presentation style and the site is very well done. I plan on visiting often! Thanks and keep up the good work. Reply View Thread	Sandesh Lal	9/4/2006 2:30:01 PM
Full page postbacks vs AJAX Great Job on the Article - it looks great! Have you thought about how to handle both a full page postback or an AJAX event? I don't think most people write an app these days that wasn't trying to do most things through AJAX. Reply View Thread	Dave	9/5/2006 8:20:35 PM
Great presentation Hi..i really like your presentation...will visit again. Reply View Thread	Bhavesh	9/7/2006 12:32:03 PM
can it be done for user controls? firstly, it's really cool. i have got user controls with a single dropdownlist and in some cases few other controls. is it possible to apply broken rule to such control as well? it would be great if that's possible. Reply View Thread	gkeeara	11/22/2006 9:00:38 PM
.net 1.1 version No biggy but i converted this to .net 1.1 in case anybody needs it. I did this because I needed exactly this for a project I just finished up. All hail the internet and the folks using it. Reply View Thread	Adam Al-Ahmary	12/6/2006 8:39:23 AM
re: .net 1.1 version Hi, Adam Could you send the 1.1 version to my e-mail adress? (heblek@gmail.com) thanks in advance onder Reply View Thread	onder	12/14/2006 4:51:18 AM
Issue I have found a problem with this. Here is what I was trying to do: I had an email text box. I wanted to make it both required, as well as validate for email address format. At first I had the call to "brokenRules.Required" and then the call to "brokenRules.AssertPattern" on the next line. When I ran the application, I tried not putting anything in the text box, it came back with an error, but the error was not telling me that it was a required field, instead it was giving me the error for the email address validation first. So then I switched the 2 calls above, and then it did give me the required error message first, but it never gave me the error message for the invalid email format. I hope this makes sense. Reply View Thread	Ehsan	1/16/2008 3:40:27 PM
re: Issue I just fixed this by including an if statement on the first check. So if it turns out that nothing was entered into the field, it won't check to see if the field had a valid email address in it. Below is an example: if (brokenRules.Required(txtEmailAddress.Text, "Email", "Email is required", txtEmailAddress, lblEmailAddress)) { brokenRules.AssertPattern(PatternType.Email, txtEmailAddress.Text, "Email", "Invalid Email", txtEmailAddress, lblEmailAddress); } Reply View Thread	Ehsan	1/16/2008 3:50:06 PM
re: Issue Glad to hear you were able to resolve the issue... Reply View Thread	Chad	2/14/2008 6:44:41 PM
Please send the Library I have gone through the demo.Its Brilliant.Please will you send the library Reply View Thread	Shaheen	3/25/2008 3:52:41 AM
Server Side Validation Library Hi How can you ensure the user made a selection from the drop down menu and that the default "space mutiny" was not submitted by mistake? Reply View Thread	gee	6/1/2008 2:29:28 AM


* Name:		Email Address:
Include me on future newsletters or mailings. (Your email address will not be displayed or shared.)
* Subject:
* Message:
Please enter the code shown below. If you cannot read it, press "reset image" to generate a new one.
		* Enter code:

Server Side Validation Library

by Chad Finsterwald

Contents

The Problem:

The Approach:

Server Side Validation Library Overview

Example One

Example Two:

Conclusion

Comments

About the Author

Chad Finsterwald

Other Articles by Chad Finsterwald: