Skip to main content

How to: Validate an Editor

  • 5 minutes to read

How to validate a single editor

  • To validate a single editor on the server side, use the ASPxEdit.IsValid property.
  • To validate a single editor on the client side, call the ASPxClientEdit.GetIsValid method. Note that the GetIsValid method does not validate editor data, it only returns an editor’s validation status.


    The code sample below implements custom validation without using any predefined validation capabilities. Note that you should set the ValidationSettings.EnableCustomValidation property to true to show an error frame.

    function OnAgeValidation(s, e) {
         var age = tbAge.GetText();
         if (age == null || age == "")
         var digits = "0123456789";
         for (var i = 0; i < age.length; i++) {
              if (digits.indexOf(age.charAt(i)) == -1) {
         if (tbAge.GetIsValid() && age.charAt(0) == '0') {
              age = age.replace(/^0+/, "");
              if (age.length == 0)
                   age = "0";
         if (age < 18) {
              tbAge.SetErrorText('Age must be greater than or equal 18');
    <dx:ASPxTextBox ID="ASPxTextBox1" runat="server" Width="170px" ClientInstanceName="tbAge">
         <ValidationSettings ValidateOnLeave="False" EnableCustomValidation="True">
    <dx:ASPxButton ID="btnValidate" runat="server" AutoPostBack="False" Text="Validate">
         <ClientSideEvents Click="OnAgeValidation" />

How to validate multiple editors simultaneously


The server-side Page.IsValid property (or the client-side Page_IsValid property) is not affected by the DevExpress control’s validation process.

Use the AreEditorsValid, ValidateEditorsInContainer, ValidateEditorsInContainerById, or ValidateGroup method to validate several editors simultaneously.


  • Use of the AreEditorsValid methods

    You can use the ASPxEdit.AreEditorsValid and ASPxClientEdit.AreEditorsValid methods to validate editors on the server and client sides, respectively. The methods validate (the ASPxEdit.IsValid property value) multiple DevExpress editors simultaneously without validating them again.


    This example demonstrates how the AreEditosValid method can be used to check the validity of several DevExpress editors. In this sample, a click on the button automatically performs client and server validations of editors contained within the same container as the button.

    Since client validation is raised automatically via a button click, it’s allowed to use the client ASPxClientEdit.AreEditorsValid method when handling the button’s client ASPxButton.Click event. If client validation passes successfully, then server validation of editors is automatically performed while processing a postback. In this case, the server ASPxEdit.AreEditorsValid method can be used to check the error state of editors.

    View Example

    <dx:ASPxButton ID="btnSubmit" runat="server" Text="Submit" OnClick="btnSubmit_Click">
        <ClientSideEvents Click="function(s, e) { 
                                    if(ASPxClientEdit.AreEditorsValid()) {
                                    // Prevent multiple presses of the button
                                        LoadingPanel.SetText('Sending data to the server...');
                                 }" />
    protected void btnSubmit_Click(object sender, EventArgs e)
        if (ASPxEdit.AreEditorsValid(FormPanel)) {
            // TODO: Write data to database
            FormPanel.Visible = false;
            SuccessPanel.Visible = true;
            // Intentionally pauses server-side processing, to demonstrate the Loading Panel functionality.


  • Use of the ValidateEditorsInContainer, ValidateEditorsInContainerById, and ValidateGroup methods

    Another solution is to use the ASPxEdit.ValidateEditorsInContainer, ASPxClientEdit.ValidateEditorsInContainer, ASPxClientEdit.ValidateEditorsInContainerById, or ASPxClientEdit.ValidateGroup method. These methods return a Boolean value that specifies editor validity. Note that the methods run the validation for each control again, even if a given control has already been validated.


    This example demonstrates how to validate editors in a container on the server side. The ASPxEdit.ValidateEditorsInContainer method is used to determine the validity of editors within a callback panel.

    View Example

    <title>How to validate editors in container </title>
    <script type="text/javascript" language="javascript">
        function Validate(s, e) {
            if (ASPxClientEdit.ValidateGroup('testGroup'))
        <form id="form1" runat="server">
            <dx:ASPxButton ID="ASPxButtonSave" runat="server" Text="Validate" AutoPostBack="False">
                <ClientSideEvents Click="Validate" />
            <br />
            <dx:ASPxCallbackPanel ID="ASPxCallbackPanelDemo" runat="server"  HideContentOnCallback="False"
                ClientInstanceName="ClientCallbackPanelDemo" OnCallback="ASPxCallbackPanelDemo_Callback">
                    <dx:PanelContent ID="PanelContent1" runat="server">
                        <table cellspacing="0" cellpadding="4" runat="server" id="serverContainer">
                                <td style="width: 60px;">
                                    <dx:ASPxLabel runat="server" ID="NameLabel" AssociatedControlID="txtNum1" Text="Number 1:" />
                                    <dx:ASPxTextBox ID="txtNum1" runat="server" Width="170px" OnValidation="ASPxTextBoxTest_Validation">
                                        <ValidationSettings ValidationGroup="testGroup">
                                            <RequiredField IsRequired="True" ErrorText="Number 1 is required" />
                                <td style="width: 60px;">
                                    <dx:ASPxLabel runat="server" ID="ASPxLabel1" AssociatedControlID="txtNum2" Text="Number 2:" />
                                    <dx:ASPxTextBox ID="txtNum2" runat="server" Width="170px" OnValidation="ASPxTextBoxTest_Validation">
                                        <ValidationSettings ValidationGroup="testGroup">
                                            <RequiredField IsRequired="True" ErrorText="Number 2 is required"/>
    using System;
    using System.Collections.Generic;
    using System.Linq;
    using System.Web;
    using System.Web.UI;
    using System.Web.UI.WebControls;
    using DevExpress.Web.ASPxEditors;
    using DevExpress.Web.ASPxCallbackPanel;
    public partial class _Default : System.Web.UI.Page {
        protected void Page_Init (object sender, EventArgs e) {
        protected void ASPxCallbackPanelDemo_Callback (object sender, DevExpress.Web.ASPxClasses.CallbackEventArgsBase e) {
            ASPxCallbackPanel callbackPanel = (ASPxCallbackPanel)sender;
            bool isValid = ASPxEdit.ValidateEditorsInContainer(callbackPanel);
        protected void ASPxTextBoxTest_Validation (object sender, ValidationEventArgs e) {
            ASPxTextBox txt = sender as ASPxTextBox;
            int val;
            bool result = Int32.TryParse(txt.Text, out val);
            e.IsValid = result;
            e.ErrorText = "An input value should be a number";