MaskedTextBox.OnValidating Method (CancelEventArgs)

 
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.

Raises the Validating event.

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

protected override void OnValidating(
	CancelEventArgs e
)

Parameters

e
Type: System.ComponentModel.CancelEventArgs

A CancelEventArgs that contains event data.

Exception Condition
Exception

A critical exception occurred during the parsing of the input string.

The OnValidating method causes the input string to be validated against the ValidatingType property, if a Type has been specified for this property. It will then also raise the TypeValidationCompleted event.

System_CAPS_noteNote

To ensure consistency with text-based controls, validation will occur even if the MaskedTextBox is read-only (its ReadOnly property is set to true).

Raising an event invokes the event handler through a delegate. For more information, see Handling and Raising Events.

The OnValidating method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class.

Notes to Inheritors:

When overriding OnValidating in a derived class, be sure to call the base class's OnValidating method so that registered delegates receive the event.

.NET Framework
Available since 2.0
Return to top
Show: