ContainerControl.Validate Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Verifies the value of the control losing focus by causing the Validating and Validated events to occur, in that order.
Overloads
Validate() |
Verifies the value of the control losing focus by causing the Validating and Validated events to occur, in that order. |
Validate(Boolean) |
Verifies the value of the control that is losing focus; conditionally dependent on whether automatic validation is turned on. |
Validate()
Verifies the value of the control losing focus by causing the Validating and Validated events to occur, in that order.
public:
bool Validate();
public bool Validate ();
member this.Validate : unit -> bool
Public Function Validate () As Boolean
Returns
true
if validation is successful; otherwise, false
. If called from the Validating or Validated event handlers, this method will always return false
.
Remarks
The Validate method validates the last child control that is not validated and its ancestors up through, but not including, the current container control. This overloaded version always performs validation, regardless of the value of the AutoValidate property of the control's parent. Therefore use it to unconditionally force validation.
See also
Applies to
Validate(Boolean)
Verifies the value of the control that is losing focus; conditionally dependent on whether automatic validation is turned on.
public:
bool Validate(bool checkAutoValidate);
public bool Validate (bool checkAutoValidate);
member this.Validate : bool -> bool
Public Function Validate (checkAutoValidate As Boolean) As Boolean
Parameters
- checkAutoValidate
- Boolean
If true
, the value of the AutoValidate property is used to determine if validation should be performed; if false
, validation is unconditionally performed.
Returns
true
if validation is successful; otherwise, false
. If called from the Validating or Validated event handlers, this method will always return false
.
Remarks
The Validate method validates the last child control that is not validated and its ancestors up through, but not including, the current container control. This overloaded version performs validation based on the following conditions:
If the
checkAutoValidate
parameter istrue
, validation always occurs for child controls that are not validated.If the
checkAutoValidate
parameter isfalse
, validation occurs only if the AutoValidate property of the control's parent is enabled.