DevExtreme Vue - Overview
Client-side data validation allows you to validate input values before sending them to the server and without reloading the page. DevExtreme ASP.NET MVC Controls validate input values using model properties' Data Annotation validation attributes. The following validation attributes are supported:
[Required]
[StringLength]
[Range]
[RegularExpression]
[Compare]
[Display]
*[DisplayName]
*[Custom]
[DevExtremeRequired]
attribute that adopts the HTML5 validation behavior: it considers false an invalid Boolean value, whereas the standard [Required]
accepts both true and false. You can find more details in this blog post.Model properties that have one or several of these attributes can be validated. For example, a Person
model contains a FirstName
property that has three validation attributes:
using System.ComponentModel.DataAnnotations; namespace ApplicationName.Models { public class Person { [Required(ErrorMessage = "First name is required")] [RegularExpression(@"^[a-zA-Z\s]+$", ErrorMessage = "Do not use digits in the first name")] [StringLength(int.MaxValue, MinimumLength = 2, ErrorMessage = "First name must have at least 2 symbols")] public string FirstName { get; set; } } }
Imports System.ComponentModel.DataAnnotations Namespace ApplicationName.Models Public Class Person <Required(ErrorMessage:="First name is required")> <RegularExpression("^[a-zA-Z\s]+$", ErrorMessage:="Do not use digits in the first name")> <StringLength(Integer.MaxValue, MinimumLength:=2, ErrorMessage:="First name must have at least 2 symbols")> Public Property FirstName() As String End Class End Namespace
To apply these validation attributes to a DevExtreme editor, create this editor using a EditorFor
method. Substitute "Editor" in EditorFor
with the editor's name. For example, to create the DevExtreme TextBox editor, call the TextBoxFor
method:
@model ApplicationName.Models.Person @(Html.DevExtreme().TextBoxFor(model => model.FirstName))
@ModelType ApplicationName.Models.Person @(Html.DevExtreme().TextBoxFor(Function(model) model.FirstName))
As an alternative, you can use a more explicit syntax for binding an editor to a model property and applying validation attributes. Pass the property's name to the Name
method and an initial value to the Value
method. The previous and following code samples produce the same result:
@model ApplicationName.Models.Person @(Html.DevExtreme().TextBox() .Name("FirstName") .Value(Model.FirstName) )
@ModelType ApplicationName.Models.Person @(Html.DevExtreme().TextBox() _ .Name("FirstName") _ .Value(Model.FirstName) )
The input value is validated each time the change event is raised by default. To change the DOM event that triggers validation, set the valueChangeEvent option.
@(Html.DevExtreme().TextBoxFor(model => model.FirstName) .ValueChangeEvent("keyup") )
@(Html.DevExtreme().TextBoxFor(Function(model) model.FirstName) _ .ValueChangeEvent("keyup") )
If the [Range]
attribute should limit a date or time range, use the RangeAttribute
overload that accepts a type as the first argument. The date/time values must be set as strings. See an example in the following code:
namespace ApplicationName.Models { public class Person { // ... [Range(typeof(DateTime), "1/1/1901", "1/1/2016")] public DateTime BirthDate { get; set; } } }
Imports System.ComponentModel.DataAnnotations Namespace Models Public Class Person ' ... <Range(GetType(DateTime), "1/1/1901", "1/1/2016")> Public Property BirthDate() As DateTime End Class End Namespace
See Also
If you have technical questions, please create a support ticket in the DevExpress Support Center.