A control used for the challenge-response authentication.
public class ASPxCaptcha : ASPxWebControl, IRequiresLoadPostDataControl
Public Class ASPxCaptcha Inherits ASPxWebControl Implements IRequiresLoadPostDataControl
The ASPxCaptcha class implements the functionality of a challenge-response authentication test, which enables verifying that submitted data came from a human, and not a robot or script.
The control consists of the following elements:
- Challenge image is an automatically generated image representation of a random text. The image settings can be customized using the ASPxCaptcha.ChallengeImage property. To define a set of characters from which a random text should be generated, use the control’s ASPxCaptcha.CharacterSet property. You can control the number of characters to be displayed within the challenge image by using the ASPxCaptcha.CodeLength property. If you want to render a custom challenge image, you can handle the ASPxCaptcha.ChallengeImageCustomRender event.
- The Refresh button allows changing the code displayed within the challenge image. To control the refresh button’s content and appearance, use the ASPxCaptcha.RefreshButton and ASPxCaptcha.RefreshButtonStyle properties.
- The Text box allows end-users to input text recognized from the challenge image. To customize the content and layout of the text box element, use the ASPxCaptcha.TextBox property. The element’s appearance can be defined using properties available via the ASPxCaptcha.TextBoxStyle property. The text box element also has a built-in validation mechanism whose behavior can be customized using the settings accessed via the ASPxCaptcha.ValidationSettings property. The availability of the built-in validation is controlled by the CaptchaValidationSettings.EnableValidation property.
- The Loading panel is displayed when the challenge image’s code is refreshed. Use the ASPxCaptcha.LoadingPanel and the ASPxCaptcha.LoadingPanelImage properties to specify the panel’s settings and image.
- The control’s client-side equivalent is represented by the ASPxClientCaptcha object.
- On the client side, the client object can be accessed directly by the name specified via the ASPxCaptcha.ClientInstanceName property.
- The available client events can be accessed by using the ASPxCaptcha.ClientSideEvents property.
The control’s client-side API is enabled if the ASPxCaptcha.ClientInstanceName property is defined, or any client event is handled.