Page.Validate Method ()

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Instructs any validation controls included on the page to validate their assigned information.

Namespace:   System.Web.UI
Assembly:  System.Web (in System.Web.dll)

abstract Validate : unit -> unit
override Validate : unit -> unit

This method is invoked when a user clicks any ASP.NET server control that has the CausesValidation property set to true, which is the default. These include the Button, ImageButton, and LinkButton Web server controls, the HtmlInputButton, HtmlInputImage, and HtmlButton HTML server controls, and controls that can automatically post back to the server such as the TextBox, CheckBox, ListControl, and BulletedList controls.

To disable validation for any button control on the page, set the button control's CausesValidation property to false.

When this method is invoked, it iterates through the validation controls contained in the ValidatorCollection object associated with the Page.Validators property and invokes the validation logic for each validation control in the current validation group. The validation group is determined by the control that posted the page to the server. If no validation group is specified, then no validation group is used.

System_CAPS_noteNote

The behavior of page validation has changed. In ASP.NET 2.0, controls no longer call the Page.Validate() method; they use the Page.Validate(String) method instead. If you use the Page.Validate() method on an ASP.NET 2.0 page, validation groups are ignored and all controls are validated.

Notes to Inheritors:

The Validate method is not used by ASP.NET 2.0. When you are using ASP.NET 2.0, override the Validate(String) method to change page validation behavior.

The following code example calls the Validate method on a page in a scenario with several different validation groups defined.

System_CAPS_security Security Note

This example has a text box that accepts user input, which is a potential security threat. By default, ASP.NET Web pages validate that user input does not include script or HTML elements. For more information, see Script Exploits Overview.

No code example is currently available or this language may not be supported.

.NET Framework
Available since 1.1
Return to top
Show: