Validation
Wisej.Web.Validation
Namespace: Wisej.Web
Assembly: Wisej.Framework (3.2.0.0)
Adds a common validation system to any Control.
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()
![](https://docs.wisej.com/~gitbook/image?url=https%3A%2F%2F3811934619-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FaN9qL9rX9v301dsI6CfD%252Fuploads%252Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%252Finstance.png%3Falt%3Dmedia%26token%3Dbc63f9cf-3241-48ac-8cb4-46d1df1d13df&width=300&dpr=4&quality=100&sign=3f055c39&sv=1)
Initializes a new instance of the Validation class.
Validation(container)
![](https://docs.wisej.com/~gitbook/image?url=https%3A%2F%2F3811934619-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FaN9qL9rX9v301dsI6CfD%252Fuploads%252Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%252Finstance.png%3Falt%3Dmedia%26token%3Dbc63f9cf-3241-48ac-8cb4-46d1df1d13df&width=300&dpr=4&quality=100&sign=3f055c39&sv=1)
Initializes a new instance of the Validation class attached to a IContainer implementation.
Name | Type | Description |
---|---|---|
container | An IContainer that represents the container of the Validation extender. |
Properties
ErrorProvider
![](https://docs.wisej.com/~gitbook/image?url=https%3A%2F%2F3811934619-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FaN9qL9rX9v301dsI6CfD%252Fuploads%252Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%252Finstance.png%3Falt%3Dmedia%26token%3Dbc63f9cf-3241-48ac-8cb4-46d1df1d13df&width=300&dpr=4&quality=100&sign=3f055c39&sv=1)
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.
The Label (or any Control that implements IErrorProvider) is automatically hidden (Visible is set to false) when there is no error message to display.
Tag
![](https://docs.wisej.com/~gitbook/image?url=https%3A%2F%2F3811934619-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FaN9qL9rX9v301dsI6CfD%252Fuploads%252Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%252Finstance.png%3Falt%3Dmedia%26token%3Dbc63f9cf-3241-48ac-8cb4-46d1df1d13df&width=300&dpr=4&quality=100&sign=3f055c39&sv=1)
Object: Returns or sets the object that contains programmer-supplied data associated with the Validation extender. (Default: null
)
Methods
CanExtend(extendee)
![](https://docs.wisej.com/~gitbook/image?url=https%3A%2F%2F3811934619-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FaN9qL9rX9v301dsI6CfD%252Fuploads%252Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%252Finstance.png%3Falt%3Dmedia%26token%3Dbc63f9cf-3241-48ac-8cb4-46d1df1d13df&width=300&dpr=4&quality=100&sign=3f055c39&sv=1)
Returns a value indicating whether a control can be extended.
Parameter | Type | Description |
---|---|---|
extendee | The control to be extended. |
Returns: Boolean. true if the control can be extended; otherwise, false.
Clear()
![](https://docs.wisej.com/~gitbook/image?url=https%3A%2F%2F3811934619-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FaN9qL9rX9v301dsI6CfD%252Fuploads%252Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%252Finstance.png%3Falt%3Dmedia%26token%3Dbc63f9cf-3241-48ac-8cb4-46d1df1d13df&width=300&dpr=4&quality=100&sign=3f055c39&sv=1)
Removes all validation rules.
GetValidationRules(control)
![](https://docs.wisej.com/~gitbook/image?url=https%3A%2F%2F3811934619-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FaN9qL9rX9v301dsI6CfD%252Fuploads%252Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%252Finstance.png%3Falt%3Dmedia%26token%3Dbc63f9cf-3241-48ac-8cb4-46d1df1d13df&width=300&dpr=4&quality=100&sign=3f055c39&sv=1)
Returns the collection of ValidationRule associated with the specified control .
Parameter | Type | Description |
---|---|---|
control | Control associated with the validation rules to retrieve. |
Returns: ValidationRule[]. Array of the validation rules associated to the control .
OnValidated(e)
![](https://docs.wisej.com/~gitbook/image?url=https%3A%2F%2F3811934619-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FaN9qL9rX9v301dsI6CfD%252Fuploads%252Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%252Finstance.png%3Falt%3Dmedia%26token%3Dbc63f9cf-3241-48ac-8cb4-46d1df1d13df&width=300&dpr=4&quality=100&sign=3f055c39&sv=1)
Fires the Validated event.
Parameter | Type | Description |
---|---|---|
e |
OnValidating(e)
![](https://docs.wisej.com/~gitbook/image?url=https%3A%2F%2F3811934619-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FaN9qL9rX9v301dsI6CfD%252Fuploads%252Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%252Finstance.png%3Falt%3Dmedia%26token%3Dbc63f9cf-3241-48ac-8cb4-46d1df1d13df&width=300&dpr=4&quality=100&sign=3f055c39&sv=1)
Fires the Validating event.
Parameter | Type | Description |
---|---|---|
e |
ResetValidationRules(control)
![](https://docs.wisej.com/~gitbook/image?url=https%3A%2F%2F3811934619-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FaN9qL9rX9v301dsI6CfD%252Fuploads%252Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%252Finstance.png%3Falt%3Dmedia%26token%3Dbc63f9cf-3241-48ac-8cb4-46d1df1d13df&width=300&dpr=4&quality=100&sign=3f055c39&sv=1)
Removes all the validation rules from the control .
Parameter | Type | Description |
---|---|---|
control | Control to remove from the Validation extender. |
SetValidationRules(control, rules)
![](https://docs.wisej.com/~gitbook/image?url=https%3A%2F%2F3811934619-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FaN9qL9rX9v301dsI6CfD%252Fuploads%252Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%252Finstance.png%3Falt%3Dmedia%26token%3Dbc63f9cf-3241-48ac-8cb4-46d1df1d13df&width=300&dpr=4&quality=100&sign=3f055c39&sv=1)
Sets the list of validation rules associated with the specified control .
Parameter | Type | Description |
---|---|---|
control | Control associated with the validation rules. | |
rules | List of validation rules to enforce on the specified control . |
Events
Validated
![](https://docs.wisej.com/~gitbook/image?url=https%3A%2F%2F3811934619-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FaN9qL9rX9v301dsI6CfD%252Fuploads%252Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%252Finstance.png%3Falt%3Dmedia%26token%3Dbc63f9cf-3241-48ac-8cb4-46d1df1d13df&width=300&dpr=4&quality=100&sign=3f055c39&sv=1)
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.
Validating
![](https://docs.wisej.com/~gitbook/image?url=https%3A%2F%2F3811934619-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FaN9qL9rX9v301dsI6CfD%252Fuploads%252Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%252Finstance.png%3Falt%3Dmedia%26token%3Dbc63f9cf-3241-48ac-8cb4-46d1df1d13df&width=300&dpr=4&quality=100&sign=3f055c39&sv=1)
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.
Last updated