Name

RadioButtonList

Synopsis

This class represents a list of radio buttons that allow only a single selection. Though this class is generated out of individual radio buttons, it acts like an integrated list. For example, ASP.NET will add or remove items as needed when you bind this control to a data source. You can use RepeatDirection to specify how items will be grouped together if RepeatColumns is greater than 1. For example, if you set RepeatDirection to RepeatDirection.Vertical, and RepeatColumns to 2, the first two list items will be displayed in the first columns, the next two will be displayed on the second column, and so on. If you set RepeatDirection to RepeatDirection.Horizontal, your list will still have the same number of rows and columns, but radio button items will be filled first by column, and then by row.

Individual radio buttons are automatically grouped together in an HTML table, which you can fine-tune with the CellPadding and CellSpacing properties. Alternatively, you can set RepeatLayout to RepeatLayout.Flow to specify that an HTML table should not be used.

Most list-specific functionality, such as determining the selected item and reacting to a SelectedIndexChanged event, is provided by the ListControl class, from which RadioButtonList inherits.

Public Class RadioButtonList : Inherits ListControl : Implements_
       IRepeatInfoUser, System.Web.UI.INamingContainer,_ 
        System.Web.UI.IPostBackDataHandler
' Public Constructors
   Public Sub New() 
' Public Instance Properties ...

Get ASP.NET in a Nutshell now with the O’Reilly learning platform.

O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.