Blazorise Validation API

Parameter	Default	Type
`ChildContent`	`null`	`RenderFragment`
Specifies the content to be rendered inside this Validations.
`EditContext`	`null`	`EditContext`
Supplies the edit context explicitly. If using this parameter, do not also supply Model, since the model value will be taken from the EditContext.Model property.
`HandlerType`	`null`	`Type`
Specifies the default handler type that will be used by the validation, unless it is overriden by HandlerType property.
`MissingFieldsErrorMessage`	`One or more fields have an error. Please check and try again.`	`string`
Message that will be displayed if any of the validations does not have defined error message.
`Mode`	`Auto`	`ValidationMode`
Specifies the validation mode for validations inside of this container. Possible values:`AutoManual`
`Model`	`null`	`object`
Specifies the top-level model object for the form. An edit context will be constructed for this model. If using this parameter, do not also supply a value for EditContext.
`ValidateOnLoad`	`true`	`bool`
If set to true, and Mode is set to Auto, validation will run automatically on page load. When validation is placed inside of modal dialog, the behavior is a little different. Modals are by definition always loaded and are always present in the DOM so no loading is ever happening again after the page that contains the modal is first initialized. Their visibility is controlled by display: none; To workaround this, the actual "first load" for modals can be done by re-initializing Model parameter.

Parameter	Default	Type
`ChildContent`	`null`	`RenderFragment`
Specifies the content to be rendered inside this Validation.
`HandlerType`	`null`	`Type`
Forces the custom validation handler to be used while validating the values.
`Status`	`ValidationStatus.None`	`ValidationStatus`
Gets the last received validation status. Possible values:`NoneSuccessWarningError`
`UsePattern`	`false`	`bool`
Forces validation to use regex pattern matching instead of default validator handler.

Parameter	Default	Type
`ChildContent`	`null`	`RenderFragment`
Specifies the content to be rendered inside this ValidationNone.

Parameter	Default	Type
`ChildContent`	`null`	`RenderFragment`
Specifies the content to be rendered inside this ValidationSuccess.
`Tooltip`	`false`	`bool`
Shows the tooltip instead of label.

Parameter	Default	Type
`ChildContent`	`null`	`RenderFragment`
Specifies the content to be rendered inside this ValidationWarning.
`Multiline`	`false`	`bool`
If true, shows the multiline warning messages.
`Tooltip`	`false`	`bool`
If true, shows the tooltip instead of label.

Parameter	Default	Type
`ChildContent`	`null`	`RenderFragment`
Specifies the content to be rendered inside this ValidationError.
`Multiline`	`false`	`bool`
If true, shows the multiline error messages.
`Tooltip`	`false`	`bool`
If true, shows the tooltip instead of label.

Parameter	Default	Type
`ChildContent`	`null`	`RenderFragment`
Specifies the content to be rendered inside this ValidationFeedback.
`Error`	`null`	`RenderFragment`
Content rendered when the validation status is Error.
`Multiline`	`false`	`bool`
If true, shows multiline validation messages.
`None`	`null`	`RenderFragment`
Content rendered when the validation status is None.
`Success`	`null`	`RenderFragment`
Content rendered when the validation status is Success.
`Tooltip`	`false`	`bool`
If true, shows the validation message as a tooltip.
`Warning`	`null`	`RenderFragment`
Content rendered when the validation status is Warning.

Event	Type
`FailedValidationsChanged`	`EventCallback<FailedValidationsEventArgs>`
Event is fired whenever the failed validation messages change.
`StatusChanged`	`EventCallback<ValidationsStatusChangedEventArgs>`
Event is fired whenever there is a change in validation status.
`ValidatedAll`	`EventCallback`
Event is fired only after all of the validation are successful.

Event	Type
`AsyncValidator`	`Func<ValidatorEventArgs, CancellationToken, Task>`
Gets the asynchronous validator handler attached to this validation.
`MessageLocalizer`	`Func<string, IEnumerable<string>, string>`
Overrides the message that is going to be shown on the ValidationError or ValidationSuccess.
`StatusChanged`	`EventCallback<ValidationStatus>`
Occurs each time that validation status changed.
`Validator`	`Action<ValidatorEventArgs>`
Gets the validator handler attached to this validation.

Method	Return	Parameters
`ClearAll`	`Task`	—
Clears all validation statuses.
`NotifyValidationInitialized`	`void`	`IValidation validation`
Notifies the validation system that a new validation component has been initialized and adds it to the list of validations if not already present.
`NotifyValidationRemoved`	`void`	`IValidation validation`
Notifies the validation system that a validation component is being removed and removes it from the list of validations if present.
`NotifyValidationStatusChanged`	`void`	`IValidation validation`
Notifies the validation system that the status of a validation component has changed. This method handles the logic for updating the overall validation status based on the mode (Auto or Manual) and the current validation results. In Auto mode, this method triggers the aggregation of validation results and potentially raises a status changed event. It is designed to minimize the number of status changed events by aggregating validation results. Special consideration is needed to ensure that the status changed event is raised only once per validation cycle, even if multiple validations fail.
`RetriggerValidation`	`Task`	`Expression<Func<object>>[] expressions`
Retriggers validations for the specified model fields.
`RetriggerValidation`	`Task`	`FieldIdentifier[] fieldIdentifiers`
Retriggers validations that match the given FieldIdentifier instances.
`ValidateAll`	`Task<bool>`	—
Asynchronously runs the validation process for all validations and returns false if any is failed.

Method	Return	Parameters
`Clear`	`void`	—
Clears the validation status.
`InitializeInputExpression`	`Task`	`Expression<Func<T>> expression`
Initializes or updates the input based on a specified expression. This is primarily used for data-annotation validation. This method is designed to work with models and edit contexts, allowing for dynamic validation based on expressions. It ensures that validation is only re-triggered if the component has been initialized and validation conditions are met.
`InitializeInputPattern`	`Task`	`string patternString, T value`
Initializes or updates the input validation pattern. If the pattern string changes, a new regex pattern is created, and the input is re-validated if applicable. This method optimizes performance by avoiding re-instantiation of the regex pattern if it has not changed. It ensures that validation is only re-triggered if the component has been initialized and validation conditions are met.
`InitializeInput`	`Task`	`IValidationInput inputComponent`
Initializes the input component with the specified validation input. It performs an initial validation if the mode is set to auto validation and validation on load is enabled. This method sets the input component and, based on the configuration, may asynchronously validate the component's validation value. It also marks the component as initialized.
`NotifyInputChanged`	`Task`	`T newExpressionValue, bool overrideNewValue`
Notifies that an input's value has changed and optionally re-validates the input. If the edit context is set and a field identifier has been established, this method notifies the edit context of the field change. It then conditionally triggers validation based on the component's mode.
`NotifyValidationStarted`	`void`	—
Notifies the validation that validation process has being activated.
`NotifyValidationStatusChanged`	`void`	`ValidationStatus status, IEnumerable<string> messages`
Notifies the validation with the new status and messages.
`RetriggerValidation`	`Task<ValidationStatus>`	—
Runs the asynchronous validation process using the current input value. Can be used to manually retrigger validation.
`ValidateAsync`	`Task<ValidationStatus>`	—
Runs the asynchronous validation process based on the last available value.
`ValidateAsync`	`Task<ValidationStatus>`	`object newValidationValue`
Runs the asynchronous validation process.
`Validate`	`ValidationStatus`	—
Runs the validation process.
`Validate`	`ValidationStatus`	`object newValidationValue`
Runs the validation process.

Blazorise Validation API

API

Parameters

Validations

Validation

ValidationNone

ValidationSuccess

ValidationWarning

ValidationError

ValidationFeedback

Events

Validations

Validation

Methods

Validations

Validation

On this page