CaptchaValidationSettings.EnableValidation Property

Gets or sets a value that specifies whether validation is performed when the editor is set to validate when a postback occurs.

Namespace: DevExpress.Web.Captcha

Assembly: DevExpress.Web.v24.1.dll

NuGet Package: DevExpress.Web

Declaration

C#

[DefaultValue(true)]
public bool EnableValidation { get; set; }

VB.NET

<DefaultValue(True)>
Public Property EnableValidation As Boolean

Property Value

Type	Default	Description
Boolean	true	true if validation is performed when the editor is set to validate when a postback occurs; otherwise, false.

Property Paths

You can access this nested property as listed below:

Library	Object Type	Path to EnableValidation
ASP.NET Web Forms Controls	ASPxCaptcha	.ValidationSettings .EnableValidation
ASP.NET MVC Extensions	CaptchaSettings	.ValidationSettings .EnableValidation

Remarks

When the value of the EnableValidation property is set to true, you can also use the ValidationSettings.ValidationGroup property to specify the name of the validation group for which the editor is validated.

Example

The following part of the ASPxCaptcha - Custom Appearance online demo illustrates how to implement a captcha control with a custom appearance.

In this example, the control’s Refresh Button.ASPxCaptcha and Text Box.ASPxCaptcha are hidden, and their functionaliry is implemented in a custom manner using separate controls (the IMG element, ASPxLabel, ASPxTextBox).

JS

function GetRefreshButton() {
    return document.getElementById("refreshButton");
}        

function OnCaptchaBeginCallback(s, e) {
    var refreshButton = GetRefreshButton();
    refreshButton.src = "Images/refreshButtonAnimated.gif";
}

function OnCaptchaEndCallback(s, e) {
    var refreshButton = GetRefreshButton();
    refreshButton.src = "Images/refreshButton.gif"; 
    tbCode.SetValue("");
...   
}

ASPX

<img id="refreshButton" src="Images/refreshButton.gif" alt="Show another code" title="" 
class="refreshButton" onclick="captcha.Refresh();" />
...
<dx:ASPxCaptcha ID="Captcha" runat="server" SkinID="dummy" ClientInstanceName="captcha" 
CodeLength="6">
    <ChallengeImage BackgroundColor="Transparent" ForegroundColor="#676767" BorderWidth="0"
        Height="72" />
    <ValidationSettings EnableValidation="False">
    </ValidationSettings>
    <TextBox Visible="False" />
    <RefreshButton Visible="False">
    </RefreshButton>
    <LoadingPanel Enabled="False" />
    <ClientSideEvents BeginCallback="OnCaptchaBeginCallback" 
        EndCallback="OnCaptchaEndCallback" />
</dx:ASPxCaptcha>
...
<dx:ASPxLabel ID="lblCode" runat="server" AssociatedControlID="tbCode" Text="Type the code">
</dx:ASPxLabel>
...
<dx:ASPxTextBox ID="tbCode" runat="server" Width="200px" AutoCompleteType="Disabled"
    BackColor="Transparent" ClientInstanceName="tbCode">
    <Border BorderWidth="0px" />
</dx:ASPxTextBox>
...
<dx:ASPxButton ID="btnSubmit" runat="server" Text="Submit" UseSubmitBehavior="true"
    AutoPostBack="true" Width="175px">
</dx:ASPxButton>