Log In
[Expand]Welcome to DevExpress .NET Documentation
[Expand]WinForms Controls
[Collapse]ASP.NET Controls and MVC Extensions
 [Expand]What's Installed
 [Expand]Common Concepts
 [Collapse]ASP.NET WebForms Controls
   Getting Started
  [Expand]Chart Control
  [Expand]Grid View
  [Expand]Card View
  [Expand]Vertical Grid
  [Expand]Rich Text Editor
  [Expand]Image and Data Browsing
  [Expand]Docking and Popups
  [Expand]Site Navigation and Layout
  [Expand]File Management
  [Expand]Multi-Use Site Controls
  [Expand]HTML Editor
  [Expand]Pivot Grid
  [Expand]Tree List
  [Collapse]Data Editors
   [Expand]Product Information
   [Expand]Common Concepts
   [Collapse]Editor Types
  [Expand]Spell Checker
  [Expand]Query Builder
 [Expand]ASP.NET MVC Extensions
 [Expand]Redistribution and Deployment
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Document Server
[Expand]Report Server
[Expand]eXpressApp Framework
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation


The ASPxButton control extends standard button functionality by providing an enhanced client API, which supports the DevExpress appearance customization mechanism and allows to automatically trigger validation mechanism for DevExpress web controls on both the client side and the server side.

ASPxButton provides the following features:

  • Radio Button Functionality

    It is possible to create a set of mutually exclusive buttons (similar to the functionality found in radio buttons). This can be accomplished by using the ASPxButton.Checked property. To create a mutually exclusive set of buttons, use the ASPxButton.GroupName property to specify a group of button controls. Once the ASPxButton.GroupName property has been set, only one ASPxButton in the specified group can be checked at one time. The checked state's appearance can be customized by using the ASPxButton.CheckedStyle property. When a button's checked state is changed, the ASPxButton.CheckedChanged event is raised. Refer to the Button Features online demo to see the radio button functionality in action.

  • Native Rendering

    ASPxButton can be rendered as a native HTML input element of the button type. When native HTML mode is enabled, a control's appearance depends on how the client browser renders native HTML elements. This reduces the amount of HTML code generated, and improves the editor's overall performance. Set the ASPxButton.Native property value to true to enable native rendering.

  • Two Render Modes

    ASPxButton allows you to specify which HTML element is used to render a button: an input (<input>) or a hyperlink (<a>). This behavior is controlled by the ASPxButton.RenderMode property.

  • Built-in Validation

    The ASPxButton control allows you to perform data validation on both the client and server side. See the Validation topic to learn more.

  • Appearance Customization

    Appearance Description

    Native HTML button input element

    When the ASPxButton control is rendered as a native HTML button input element, the button is painted in native Windows style, and the button's appearance depends only on the system settings.

    Apply DevExpress Themes

    This feature allows you to change how a control looks or behaves with just a couple of mouse clicks.

    Different button appearance properties

    The ASPxButton control can be represented by the following elements:

    • Image - The entire button is represented by a single image.
    • Image and Text - Button content is represented by a combination of an image and text.
    • Background Image and Text. Button content is represented by a combination of a background image and text.

  • Full-Featured Client-Side API

    ASPxButton provides a comprehensive client-side API. This API is implemented with JavaScript and is exposed via the ASPxClientButton object. The ASPxClientButton object serves as the client-side equivalent of the ASPxButton control.

    You can operate with editor values using the following methods.

    Method Description
    ASPxClientButton.DoClick Simulates a mouse click action on the button control.
    ASPxClientButton.Focus Sets input focus to the button.
    ASPxClientButton.GetChecked Returns a value indicating whether the button is checked.
    ASPxClientButton.SetChecked Sets a value that specifies the button's checked status.
    ASPxClientButton.GetEnabled Returns a value indicating whether the button is enabled.
    ASPxClientButton.SetEnabled Sets a value specifying whether the button is enabled.
    ASPxClientButton.GetImageUrl Returns the URL pointing to the image displayed within the button.
    ASPxClientButton.SetImageUrl Sets the URL pointing to the image displayed within the button.
    ASPxClientButton.GetText Returns the text displayed within the button.
    ASPxClientButton.SetText Sets the text to be displayed within the button.

Expanded See Also

Online Demos:
Is this topic helpful?​​​​​​​