[Expand]General Information
[Expand]WinForms Controls
[Collapse]ASP.NET Controls and MVC Extensions
 [Expand]Prerequisites
 [Expand]What's Installed
 [Expand]Common Concepts
 [Expand]ASP.NET WebForms Controls
 [Collapse]ASP.NET MVC Extensions
  [Expand]Product Information
  [Expand]Getting Started
  [Expand]Common Concepts
  [Expand]Grid View
  [Expand]Tree List
  [Expand]Card View
   Reporting
  [Expand]Charting
  [Expand]Pivot Grid
   Spreadsheet
   Rich Text Editor
  [Expand]Scheduler
  [Expand]Site Navigation and Layout
  [Expand]HTML Editor
  [Expand]Vertical Grid
  [Collapse]Data Editors
    Editor List
    Main Features
   [Expand]Common Concepts
    BinaryImage
   [Expand]Button
    ButtonEdit
    Calendar
   [Expand]Captcha
    CheckBox
    CheckBoxList
   [Expand]ColorEdit
   [Expand]ComboBox
   [Expand]DateEdit
    DropDownEdit
    Filter Control
    GridLookup
    HyperLink
    Image
    Label
    ListBox
    Memo
   [Expand]ProgressBar
    RadioButton
    RadioButtonList
    SpinEdit
    TextBox
    TimeEdit
    TokenBox
   [Expand]TrackBar
    Validation Summary
   [Expand]Strongly-Typed Editor Types
  [Expand]Docking and Popups
  [Expand]File Management
  [Expand]Data and Image Navigation
  [Expand]Multi-Use Site Extensions
  [Expand]Spell Checker
  [Expand]Query Builder
 [Expand]Localization
 [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]Office File API
[Expand]Reporting
[Expand]Report and Dashboard Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]eXpress Persistent Objects
[Expand]CodeRush
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)

RadioButton

RadioButton is a button control that can be selected, but not cleared, by an end-user. While paired with other radio buttons, RadioButton enables end-users to select a single option from a group of choices.

Expanded Implementation Details

RadioButton is realized by the RadioButtonExtension class. Its instance can be accessed via the ExtensionsFactory.RadioButton helper method, which is used to add a RadioButton extension to a view. This method's parameter provides access to the RadioButton settings implemented by the RadioButtonSettings class, allowing you to fully customize the extension.

RadioButton's client counterpart is represented by the ASPxClientRadioButton object.

Expanded Declaration

RadioButton can be added to a view in the following manner.

View code (ASPX):

View code (Razor):

Note

The Partial View should contain only the extension's code.

The code result is demonstrated in the image below.

Expanded Main Features

  • Native Rendering

    The RadioButton supports native rendering as a native HTML input element of the radio type. When the native HTML mode is enabled, an extension appearance depends on how a client browser renders native HTML elements. This reduces the render size and improves the editor's overall performance. Set the RadioButtonSettings.Properties.Native property value to true to enable native rendering.

  • Appearance Customization

    A radio button edit region (check mark) is represented by an image within the RadioButton editor by default. It is possible to assign your own images to be displayed for different check states.

    You can customize the extension appearance using predefined built-in visual themes. See this topic to learn more: Applying Themes.

  • Built-in Validation

    The RadioButton extension allows you to perform data validation both on the client and server side. See the Built-in Validation topic to learn more.

  • Full-Featured Client-Side API

    The RadioButton provides you with a comprehensive client-side API. This API is implemented using JavaScript and is exposed via the ASPxClientRadioButton object. The ASPxClientRadioButton object serves as a client-side equivalent of the RadioButton extension.

Is this topic helpful?​​​​​​​