Back to Devexpress

CaptchaValidationSettings.EnableValidation Property

aspnet-devexpress-dot-web-dot-captcha-dot-captchavalidationsettings.md

latest4.5 KB
Original Source

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.v25.2.dll

NuGet Package : DevExpress.Web

Declaration

csharp
[DefaultValue(true)]
public bool EnableValidation { get; set; }
vb
<DefaultValue(True)>
Public Property EnableValidation As Boolean

Property Value

TypeDefaultDescription
Booleantrue

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:

LibraryObject TypePath to EnableValidation
ASP.NET MVC ExtensionsCaptchaSettings

.ValidationSettings .EnableValidation

| | ASP.NET Web Forms Controls | ASPxCaptcha |

.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).

javascript
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

...
<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>

See Also

Captcha Control

CaptchaValidationSettings Class

CaptchaValidationSettings Members

DevExpress.Web.Captcha Namespace