ASPxValidationSummary.ClientSideEvents Property

Gets an object that lists the client-side events specific to the editor.

Namespace: DevExpress.Web

Assembly: DevExpress.Web.v20.2.dll

NuGet Package: DevExpress.Web

Declaration

C#

public ValidationSummaryClientSideEvents ClientSideEvents { get; }

VB.NET

Public ReadOnly Property ClientSideEvents As ValidationSummaryClientSideEvents

Property Value

Type	Description
ValidationSummaryClientSideEvents	A ValidationSummaryClientSideEvents object which allows assigning handlers to the client-side events available to the editor.

Remarks

The ClientSideEvents property provides access to the properties whose names correspond to the events available to an ASPxValidationSummary on the client side. These properties enable you to assign JavaScript handlers to the required client-side events of the ASPxValidationSummary.

Example

The following section of the Validation Summary online demo illustrates how to customize the settings of the ASPxValidationSummary control.

This settings are specified within a panel by using the ASPxRadioButtonList, ASPxCheckBox editors.

C#

protected void Page_Load(object sender, EventArgs e) {
    ApplyValidationSummarySettings();
    ApplyEditorsSettings();
    if(!IsPostBack && !IsCallback)
        ASPxEdit.ValidateEditorsInContainer(this);
}

private void ApplyValidationSummarySettings() {
    vsValidationSummary1.RenderMode = (ValidationSummaryRenderMode)Enum.Parse(typeof
        (ValidationSummaryRenderMode), rblRenderMode.SelectedItem.Value.ToString());
    vsValidationSummary1.ShowErrorAsLink = chbShowErrorAsLink.Checked;
}

private void ApplyEditorsSettings() {
    ASPxEdit[] editors = new ASPxEdit[] { tbName, tbEmail };
    foreach(ASPxEdit editor in editors) {
        editor.ValidationSettings.ValidateOnLeave = chbValidateOnLeave.Checked;
        editor.ValidationSettings.SetFocusOnError = chbSetFocusOnError.Checked;
    }
}

JS

function ShowHideVS(s, e) {
    if (e.visible)
        document.getElementById("errorsContainer").style.display = "block";
    else
        document.getElementById("errorsContainer").style.display = "none";
}

ASPX

<!-- DevExpress Editors for validation -->

<dx:ASPxTextBox ID="tbName" runat="server" Width="200px">
    <ValidationSettings>
        <RequiredField IsRequired="True" ErrorText="Name is required" />
        <RegularExpression ValidationExpression=".{2,}" ErrorText="Name should contain at least two letters" />
    </ValidationSettings>
</dx:ASPxTextBox>

<dx:ASPxTextBox ID="tbEmail" runat="server" Width="200px">
    <ValidationSettings>
        <RequiredField IsRequired="True" ErrorText="E-mail is required" />
        <RegularExpression ValidationExpression="\w+([-+.']\w+)*@\w+([-.]\w+)*\.\w+([-.]\w+)*" 
            ErrorText="Invalid e-mail" />
    </ValidationSettings>
</dx:ASPxTextBox>

<!-- ASPxValidationSummary -->

<dx:ASPxValidationSummary ID="vsValidationSummary1" runat="server" 
RenderMode="BulletedList" Width="243px" Paddings-PaddingLeft="14px" ClientInstanceName="validationSummary">
    <ClientSideEvents VisibilityChanged="ShowHideVS" />
</dx:ASPxValidationSummary>

<!-- Panel with settings for the ASPxValidationSummary -->

<dx:ASPxRadioButtonList ID="rblRenderMode" runat="server" SelectedIndex="0" AutoPostBack="True" RepeatDirection="Horizontal">
    <Paddings Padding="0" />
    <Border BorderStyle="None" />
    <Items>
        <dx:ListEditItem Value="BulletedList" />
        <dx:ListEditItem Value="OrderedList" />
        <dx:ListEditItem Value="Table" />
    </Items>
</dx:ASPxRadioButtonList>

<dx:ASPxCheckBox ID="chbShowErrorAsLink" runat="server" AutoPostBack="True" Checked="True" />

<dx:ASPxCheckBox ID="chbValidateOnLeave" runat="server" AutoPostBack="True" Checked="True" />

<dx:ASPxCheckBox ID="chbSetFocusOnError" runat="server" AutoPostBack="True" />