Namespace: Wisej.Web

Assembly: Wisej.Framework (3.2.0.0)

Adds a common validation system to any Control.

public class Validation : Component, IExtenderProvider

Public Class Validation
    Inherits Component
    Implements IExtenderProvider

You can drop this extender on any design surface to add validation rules to any control at design time using the added ValidationRules property. You can also use this component at runtime and invoke the SetValidationRules method directly. Validation rules are executed in the order they are added to the array. When a validation rule fails validation, the next rules are NOT executed and the Cancel property of the control's Validating event is set to true.

Constructors

Validation()

Initializes a new instance of the Validation class.

Validation(container)

Initializes a new instance of the Validation class attached to a IContainer implementation.

Properties

ErrorProvider

IErrorProvider: Associates an IErrorProvider to the Validation extender."/> (Default: null)

When this property is null (default), the validation extender sets the InvalidMessage property of the control being validated to the corresponding InvalidMessage when a validation rule fails. Otherwise it invokes the SetError method passing the control that failed validation and the corresponding InvalidMessage string. You may use an instance of ErrorProvider to display error icons and messages. But you can also implement the IErrorProvider interface in a custom class and manage errors however required by the application. A third option is to assign a Label (or any Control that implements IErrorProvider) to the ErrorProvider property to let the validation extender set the text property to the corresponding InvalidMessage string.

Object: Returns or sets the object that contains programmer-supplied data associated with the Validation extender. (Default: null)

Methods

Returns a value indicating whether a control can be extended.

Returns: Boolean. true if the control can be extended; otherwise, false.

Removes all validation rules.

Returns the collection of ValidationRule associated with the specified control .

Returns: ValidationRule[]. Array of the validation rules associated to the control .

Fires the Validated event.

Fires the Validating event.

Removes all the validation rules from the control .

Sets the list of validation rules associated with the specified control .

Events

ValidationEventHandler Fired after any control associated to the Validation extender has been successfully validated.

You can add an handler to this event and handle the successful validation of all the controls that have a set of validation rules in one place.

ValidationEventHandler Fired when the any control associated to the Validation extender is being validated.

You can add an handler to this event and handle the validation of all the controls that have a set of validation rules in one place.

Namespace: Wisej.Web

Assembly: Wisej.Framework (3.2.0.0)

Validates email addresses.

Constructors

EmailValidationRule()

Initializes a new instance of .

Properties

InvalidDomains

: Returns or sets a list of invalid domains: i.e. "dropmail.com", "protonmail.com". (Default: null)

Name

Methods

Validates the control using the validation rule.

Namespace: Wisej.Web

Assembly: Wisej.Framework (3.2.0.0)

Validates telephone numbers.

Constructors

TelephoneValidationRule()

Initializes a new instance of the class.

Properties

Format

: Returns or sets whether to format the value of the control after validation. (Default: False)

Mask

Methods

Invoked after the control has been successfully validated.

Validates the control using the validation rule.

Namespace: Wisej.Web

Assembly: Wisej.Framework (3.2.0.0)

Validates long integer values.

Constructors

IntegerValidationRule()

Initializes a new instance of the class.

Properties

MaximumValue

: Returns or sets the maximum value; or null for no maximum. (Default: null)

MinimumValue

Methods

Validates the control using the validation rule.

Namespace: Wisej.Web

Assembly: Wisej.Framework (3.2.0.0)

Validates decimal values.

Constructors

DecimalValidationRule()

Initializes a new instance of the class.

Properties

DecimalDigits

: Returns or sets the required number of decimal digits; or null to allow any number of decimals. (Default: null)

Format

Methods

Invoked after the control has been successfully validated.

Validates the control using the validation rule.

Namespace: Wisej.Web

Assembly: Wisej.Framework (3.2.0.0)

Validates currency values.

Constructors

CurrencyValidationRule()

Initializes a new instance of the class.

Properties

CurrencySymbol

: Returns or sets the currency symbol to validate. The default is null to use the current . (Default: null)

DecimalDigits

Methods

Invoked after the control has been successfully validated.

Validates the control using the validation rule.

Namespace: Wisej.Web

Assembly: Wisej.Framework (3.2.0.0)

Validates the control using a custom expression.

Constructors

RegexValidationRule()

Initializes a new instance of .

Properties

FilterExpression

: Returns or sets the filter property (i.e. ) property on editable controls that support filtering of the keys as they are typed. (Default: null)

Name

Methods

Invoked when the control associated with the validation rule is created and ready to be rendered on the client.

Validates the control using the validation rule.

Namespace: Wisej.Web

Assembly: Wisej.Framework (3.2.0.0)

Validates controls that cannot be left empty.

Constructors

RequiredValidationRule()

Initializes a new instance of the class.

Properties

MinimumLength

: Returns or sets the required minimum number of characters. (Default: null)

Name

Methods

Validates the control using the validation rule.

Namespace: Wisej.Web

Assembly: Wisej.Framework (3.2.0.0)

Represents a validation rule within an instance of the Validation extender.

public class ValidationRule

Public Class ValidationRule

Constructors

ValidationRule()

Initializes a new instance of a ValidationRule implementation.

ValidationRule(name, invalidMessage)

Initializes a new instance of a ValidationRule implementation using the specified name and optional invalidMessage .

Properties

Enabled

Boolean: Enables or disables the validation rule. Since 3.2.7 (Default: True)

IErrorProvider: Returns or sets the control that displays the InvalidMessage string. (Default: null)

String: Returns or sets the error message for the validation rule. (Default: null)

String: Returns or sets the name of the validation rule. (Default: null)

Methods

Invoked when the control associated with the validation rule is created and ready to be rendered on the client.

The ControlCreated event is fired when the control is made visible the first time and it's ready to be displayed on the client browser; it's not fire when the control is constructed. Use this overload if your custom ValidationRule needs to read or set properties on the control itself. i.e. set the Filter, or format strings.

Invoke after the control has been validated successfully.

Invoked when the control is being validated.

Returns: Boolean. true if the validation is successful; otherwise false.

Inherited By

Namespace: Wisej.Web

Assembly: Wisej.Framework (3.2.0.0)

Provides data for the Validating event handlers.

public class ValidationEventArgs : CancelEventArgs

Public Class ValidationEventArgs
    Inherits CancelEventArgs

Properties

Control

Control: Control being validated.

InvalidMessage

String: Message to return when validation fails.

Rules

ValidationRule[]: Rules associated to the Control being validated.

Used By

Namespace: Wisej.Web

Assembly: Wisej.Framework (3.2.0.0)

Represents the method that will handle the Validating event.

public delegate void ValidationEventHandler(Object sender, ValidationEventArgs e)

Public Delegate Sub ValidationEventHandler(ByVal sender As [Object], ByVal e As ValidationEventArgs)

Parameters

Fired By