CausesValidation Property
TOC
Collapse the table of content
Expand the table of content

Control.CausesValidation Property

 

Gets or sets a value indicating whether the control causes validation to be performed on any controls that require validation when it receives focus.

Namespace:   System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

member CausesValidation : bool with get, set

Property Value

Type: System.Boolean

true if the control causes validation to be performed on any controls requiring validation when it receives focus; otherwise, false. The default is true.

If the CausesValidation property is set to false, the Validating and Validated events are suppressed.

The CausesValidation property value is typically set to false for controls such as a Help button.

The following code example uses the derived classTextBox and validates an e-mail address that the user enters. If the e-mail address is not in the standard format (containing "@" and "."), the validation fails, an ErrorProvider icon is displayed, and the event is canceled. One of the buttons on the form has its CausesValidation property set to false. Clicking or setting focus to this button does not trigger validation. This example requires that a TextBox, an ErrorProvider control, and a Button have been created on a form.

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

.NET Framework
Available since 1.1
Return to top
Show:
© 2016 Microsoft