| RadioButtonList | disposable |
| System.Web.UI.WebControls (system.web.dll) | class |
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 : ListControl, IRepeatInfoUser,
System.Web.UI.INamingContainer, System.Web.UI.IPostBackDataHandler {
// Public Constructors
public
RadioButtonList ( );
// Public Instance Properties
public virtual int
CellPadding {set; get; }
public virtual int
CellSpacing {set; get; }
public virtual int
RepeatColumns {set; get; }
public virtual RepeatDirection
RepeatDirection {set; get; }
public virtual RepeatLayout
RepeatLayout {set; get; }
public virtual TextAlign
TextAlign {set; get; }
// Protected Instance Methods
protected override Style
CreateControlStyle ( ); // overrides WebControl
protected override void
Render (System.Web.UI.HtmlTextWriter
writer ); // overrides WebControl
}
Hierarchy
System.Object
System.Web.UI.Control(System.ComponentModel.IComponent,
System.IDisposable,
System.Web.UI.IParserAccessor,
System.Web.UI.IDataBindingsAccessor)
WebControl(System.Web.UI.IAttributeAccessor)
ListControl
RadioButtonList(IRepeatInfoUser,
System.Web.UI.INamingContainer,
System.Web.UI.IPostBackDataHandler)