BaseValidator

BaseValidatordisposable

System.Web.UI.WebControls (system.web.dll)abstract class

This abstract class is the basis for all validation controls. It supplies a Validate( ) method, which does not return a value, but updates the IsValid property. When using validation controls on a Web Forms page, you should check the System.Web.UI.Page.IsValid property. This value will be True only if all validation controls on the page have successfully validated their input. The BaseValidator class also provides various other methods that are not used directly when creating a Web Forms page.

The ControlToValidate property specifies the control that a validator will verify. The ErrorMessage property specifies the message that will be displayed in the validation control if validation fails, although this text can be overridden by changing the validation control's Text property. The ErrorMessage will also appear in a page's ValidationSummary control, if present.

By default, ASP.NET will not render any HTML for a control if it is not visible. This means that space will not be allocated for a validation control unless validation fails. The Display property allows you to allocate space for a validation control by specifying ValidatorDisplay.Static, which may be required if your validation control is in a table. You can also set this property to ValidatorDisplay.None to specify that no validation message will be displayed in the control, although one will still be shown in the ValidationSummary control, if used.

public abstract class BaseValidator : Label, System.Web.UI.IValidator { // Protected Constructors    protected BaseValidator( ); // Public Instance Properties    public string ControlToValidate{set; get; }    public ValidatorDisplay Display{set; get; }    public bool EnableClientScript{set; get; }    public override bool Enabled{set; get; }         // overrides WebControl    public string ErrorMessage{set; get; }           // implements System.Web.UI.IValidator    public override Color ForeColor{set; get; }                   // overrides WebControl    public bool IsValid{set; get; }                  // implements System.Web.UI.IValidator // Protected Instance Properties    protected bool PropertiesValid{get; }    protected bool RenderUplevel{get; } // Public Static Methods    public static PropertyDescriptor GetValidationProperty(object component); // Public Instance Methods    public void Validate( );                          // implements System.Web.UI.IValidator // Protected Instance Methods    protected override void AddAttributesToRender(System.Web.UI.HtmlTextWriter writer);// overrides WebControl    protected void CheckControlValidationProperty(string name, string propertyName);    protected virtual bool ControlPropertiesValid( );    protected virtual bool DetermineRenderUplevel( );    protected abstract bool EvaluateIsValid( );    protected string GetControlRenderID(string name);    protected string GetControlValidationValue(string name);    protected override void OnInit(EventArgs e);                 // overrides System.Web.UI.Control    protected override void OnPreRender(EventArgs e);            // overrides System.Web.UI.Control    protected override void OnUnload(EventArgs e);               // overrides System.Web.UI.Control    protected void RegisterValidatorCommonScript( );    protected virtual void RegisterValidatorDeclaration( );    protected override void Render(System.Web.UI.HtmlTextWriter writer);// overrides WebControl }

Hierarchy

System.Object System.Web.UI.Control(System.ComponentModel.IComponent, System.IDisposable, System.Web.UI.IParserAccessor, System.Web.UI.IDataBindingsAccessor) WebControl(System.Web.UI.IAttributeAccessor) Label BaseValidator(System.Web.UI.IValidator)

Subclasses

BaseCompareValidator, CustomValidator, RegularExpressionValidator, RequiredFieldValidator

Returned By

System.Web.UI.MobileControls.BaseValidator.CreateWebValidator( )



ASP. NET in a Nutshell
ASP.NET in a Nutshell, Second Edition
ISBN: 0596005202
EAN: 2147483647
Year: 2003
Pages: 873

flylib.com © 2008-2017.
If you may any questions please contact us: flylib@qtcs.net