Click here to Skip to main content
Click here to Skip to main content

Validators for Windows Forms - ValidationProvider Control

By , 16 Apr 2005
Rate this:
Please Sign up or sign in to vote.

Introduction

Do you spend most of your time writing custom validations on Windows Forms? Have you ever wanted an equivalent WinForm validator like in WebForm? Noogen ValidationProvider can help you speed up your WinForms design time by providing powerful, easy and virtually code-free wiring of input validations.

Background

For the beginners, I would suggest a reading of Paul Riley's article on Validators in ASP.NET/WebForms - ASP.NET Validators Unclouded. This is because ValidationProvider engine is derived from WebForm Validators base.

Noogen ValidationProvider is also built on ErrorProvider, see the article by Naveen K. Kohli - How To Use The ErrorProvider Object To Indicate Invalid Control State.

I know that this topic has been discussed many times (example MSDN article - Extending Windows Forms with a Custom Validation Component Library, Part 3), but most of the articles I've seen are either too restricted to a single control (TextBox) or too complicated. My goal with Noogen ValidationProvider is to bring all these great ideas together and simplify them.

The design

  1. To speed up development, Noogen ValidationProvider re-uses WebForm validator base engine and displays error using ErrorProvider Control (hence the name ValidationProvider).
  2. My second goal is to provide easy wiring of basic/familiar validations as seen in WebForm, which includes: DataTypes check, required field, range and value comparison validations, and more...
  3. Noogen ValidationProvider also tests and validates regular expressions and can even wire more advance custom validations.

I'll stop here before I go too far off from the topic. Of course, if you wish to drill down on the details, all the source codes are provided.

Using the code

Basic Validations

ValidationProvider makes it easy to setup validation for TextBox and ComboBox controls. You don't have to write a single line of code. Just compile the accompanied source in release mode, browse and add it to your VS.NET IDE ToolBox, drop it on the form, and you are ready to visually design your input validations.

ValidationProvider property exposes Edit ValidationRules link/verb on the "Properties Window". I have also implemented IExtenderProvider to enable easy editing of specific ValidationRule ties to individual TextBox or ComboBox controls.

The only code you will need is given below:

//
// Call Noogen ValidationProvider public method - 
// Validate() and display error if returns false.
//
this.validationProvider1.ValidationMessages(
                      !this.validationProvider1.Validate());

Public Methods

CanExtend Determine if the ValidationProvider supports a component.
GetIconAlignment Get Error Icon alignment.
GetIconPadding Get Error Icon padding.
GetValidationRule Get validation rule.
SetIconAlignment Set Error Icon alignment.
SetIconPadding Set Error Icon padding.
SetValidationRule Set validation rule.
Validate Overloaded. Perform validation on all controls.
ValidationMessages Get validation error messages.

Regular expression validations

ValidationProvider can test and validate regular expressions (RegEx). For your convenience, a RegEx test bench is provided. RegEx test value applies the same validation engine, and the data gets validated as you type in. You can wire some very powerful and advance validations with RegEx. With creativity, I believe that you can virtually use it in place of all the Basic Validations, but RegEx can be complicated to derive. Thus, you would probably use RegEx validation as an accommodation to the provided Basic Validations. The demo application demonstrates simple email and data length Regular Expression validations.

If you've worked with regular expressions before, then you would have probably collected some favorite RegEx patterns. ValidationProvider allows you to load your collection RegEx patterns so that you can re-use it consistently and share it with your developer friends. You would simply edit and add your RegEx collection to the accompanied file "RegExPatternStore.xml" as seen in the animation above.

Custom Validations

OK, I lied! The above code is not the only code you will need. When business logic gets complicated or if it is required to validate controls that the ValidationProvider does not support, custom validation methods can be wired onto ValidationProvider like this:

//
// Create new ValidationRule and wire-up custom validation method.  
// This can be somewhere in the ctor.
//
Noogen.Validation.ValidationRule vr = new Noogen.Validation.ValidationRule();
vr.CustomValidationMethod += 
 new Noogen.Validation.CustomValidationEventHandler(vr_CustomValidationMethod);
this.validationProvider1.SetValidationRule(this.textBox6, vr);
//
// The custom validation method.
//
private void vr_CustomValidationMethod(object sender, 
                 Noogen.Validation.CustomValidationEventArgs e)
{
   e.IsValid = 
        e.Value.ToString().Equals("abc") || e.Value.ToString().Equals("123") ;
   e.ErrorMessage = "%ControlName% is not in ('abc', '123').";
}

Point of interest

For the purpose of demonstration, I have put both the Noogen.Validation.Design and ValidationProvider in a single project. You would probably want to name your build of ValidationProvider to separate the Designer from the Provider. This will reduce the assembly size, since the Designer is not required for deployment.

History

  • April 11th, 2005 - ValidationProvider 1.0 posted.

License

This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.

A list of licenses authors might use can be found here

About the Author

Noogen
Web Developer
United States United States
If at first you don't succeed, refract and refract again...

Comments and Discussions

 
GeneralThank You PinmemberAwais19884-Apr-13 7:54 
Questioncontrols in different tabs PinmemberMapHash24-Jan-13 12:26 
QuestionNot Working Pinmemberonurag1911-Apr-12 7:46 
AnswerRe: Not Working PinmemberMarcus Kramer19-Apr-12 9:54 
GeneralRe: Not Working Pinmemberonurag1919-Apr-12 18:27 
QuestionNo funciona en Visual Studio 2010 Pinmemberx_jhofran_x9-Dec-11 5:19 
AnswerRe: No funciona en Visual Studio 2010 Pinmemberaleasilva27-Dec-11 12:04 
QuestionIt is not work for me in VisualStudio 2010 Pinmembernifox16-Oct-11 15:36 
AnswerRe: It is not work for me in VisualStudio 2010 Pinmembersunmil9-Jan-12 16:29 
Questioncustom validation PinmemberMember 82998517-Oct-11 20:52 
QuestionIt is not work for me in VisualStudio 2010 Pinmemberriovkiheller18-Sep-11 9:08 
AnswerRe: It is not work for me in VisualStudio 2010 Pinmembernifox16-Oct-11 15:38 
QuestionError Pinmemberminhcanhdn2-Jul-11 5:53 
GeneralVery cool, but how can it be used for controls in DataGridView? Pinmemberjaimepremy25-May-11 4:45 
GeneralThank you :) PinmemberTechnoshaman18-May-11 1:05 
GeneralMultiple validation on a single control Pinmemberpunit kumaar11-Feb-10 18:25 
GeneralValidation Int64 value PinmemberMauro Gagna9-Dec-09 0:49 
QuestionHow to Set Error Message Pinmemberaneeshkonny31-Mar-09 0:03 
GeneralThe validation property grid don't show PinmemberJoao Prado30-Jan-09 8:16 
GeneralAwesome! PinmemberRicky873-Sep-08 9:39 
QuestionHow to use with Krypton Control Kit Pinmemberbreakpoint2-Sep-08 18:41 
QuestionHow to add an option to use with other input controls? Pinmemberloverboy2319-Jul-08 7:39 
GeneralI need some help PinmemberLaco424-Mar-08 9:45 
GeneralThank you PinmemberJecho Jekov27-Dec-07 10:48 
GeneralFocus on First invalid Field PinmemberNic Roche12-Apr-07 15:19 

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

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

| Advertise | Privacy | Mobile
Web02 | 2.8.140421.2 | Last Updated 16 Apr 2005
Article Copyright 2005 by Noogen
Everything else Copyright © CodeProject, 1999-2014
Terms of Use
Layout: fixed | fluid