<RadioButtonList>

Syntax Remarks Example

The RadioButtonList tag renders as a series of mutually-exclusive option button at run-time.

Syntax

Remarks

• AccessKey: In browsers that support it, this property can be set to a character on the keyboard that can be used to set focus to the control. For instance, setting the value to F allows the user to access the control by pressing Alt+F on their keyboard (for Windows machines)
• AppendDataBoundItems: If True, items retrieved from a <controldatasource> tag will be appended to the list of items already defined in the control. This only applies if the control is bound to such a tag. The default value is False.
• BackColor: Color of the background of the control.
• BorderColor: Color of the border around the control
• BorderStyle: Style of the border around the control.
• BorderWidth: Width of the border around the control, specified in units
• CellPadding: For table layouts, sets the distance (in pixels) between the border and the content of the cells.
• CellSpacing: For table layouts, sets the distance (in pixels) between cells.
• CssClass: Name of the Cascading Style Sheets (CSS) class used to style this control
• DataField: Name of the parameter in the <submitcommand> which will be filled with this control's data on when the form is submitted and/or the parameter in the <selectcommand> which will supply this control's data when the form is loaded. This attribute is required if the control will participate in operations with your form's data commands.
• DataSourceId: If this control's data is supplied by a <controldatasource> tag, specify that tag's ID in this attribute. This attribute is required only if the control's data is supplied via a <controldatasource> tag.
• DataTextField: When using a <controldatasource> this attribute specifies the column name in that datasource that supplies each list item's display text. This attribute is required if the control's data is supplied via a <controldatasource> tag.
• DataType: The type of data this control is supplying to the data commands. This is a Database type. Valid values are: string (default), int32, int64, boolean, . This attribute is required if the control will participate in operations with your form's data commands.
• DataValueField: When using a <controldatasource> this attribute specifies the column name in that datasource that supplies each list item's hidden value. This attribute is required only if the control's data is supplied via a <controldatasource> tag.
• Font Properties: A series of attributes such as font-bold, font-size, etc. that allow you to control how the text in the control is displayed. More
• ForeColor: Sets the foreground color (typically the color of the text) of the control.
  
• Height: Height of the control, specified in units.
• ID: Name, consisting of letters and numbers, beginning with a letter, that uniquely identifies the control within the form.
• Nullable: If True (the default is False), this control returns a DBNull value if no item has been selected. If a DBNull value is passed to the control, regardless of the Nullable setting, all items will be de-selected.
• RepeatColumns: Defines the number of columns to use when laying out the checkboxes.
• RepeatDirection: Determines if the control displays vertically or horizontally.
• RepeatLayout: Use this attribute to specify whether the items in the control are displayed in a table. If this attribute is set to Table the items in the list are displayed in a table. If this attribute is set to Flow, the items in the list are displayed without a table structure.
• Style: Same as the HTML style attribute.It allows you to apply CSS styling to the control (e.g. "color: red; border: solid 1px black;")
• TextAlign: The alignment of the text label with respect to its associated radio button. Valid values are Left and Right. Default value is Right.
• Visible: Determines if the control is visible (true) or hidden (false)
• Width: Width of the control in units.
• Usage: The control allows <listitem> child tags which define the items that will appear in the list. The control can also be bound to a <controldatasource> tag. To do so, specify the ID of the <controldatasource> tag in the DataSourceId attribute, the name of the column in the data source that should supply the display text for each list item in the DataTextField attribute, and the column in the data source that should supply the hidden value of each list item in the DataValueField attribute.

Example