---
title: SAIFRadioButtonList
summary: API reference for SAIFRadioButtonList.
status: draft
owner: SAIF Documentation Team
last_reviewed: 2026-08-17
library: SAIF.Presentation.Web.Controls.V2
reference_type: package
---

# SAIFRadioButtonList

`SAIFRadioButtonList` is a `RadioButtonList` subclass extending the same read-only static-image rendering convention as `SAIFRadioButton` to a list of radio items, rendered as an HTML table ([BR-V2-003](../../business-rules.md#br-v2-003-read-only-input-controls-render-as-static-images-not-native-controls)).

## Purpose
- Provide a consistent "locked field" visual convention for radio-button lists (matching `SAIFRadioButton`'s single-item behavior) across the SAIF UI.

## Context
- Namespace: `SAIF.Presentation.Web.Controls.V2`
- Assembly/package: Compiled into `SAIF.BOF.Presentation.Web.Infragistics103`*

## Public members
| Member | Signature | Purpose |
| --- | --- | --- |
| `[ReadOnly]` | `Property [ReadOnly] As Boolean` | Switches the control from its native interactive `RadioButtonList` rendering to a static `<table>` of checked/unchecked images and labels, per [BR-V2-003](../../business-rules.md#br-v2-003-read-only-input-controls-render-as-static-images-not-native-controls). |

## Inherited public members

`SAIFRadioButtonList` inherits from `RadioButtonList` (`System.Web.UI.WebControls`), a framework base class rather than a documented SAIF dependency library.

| Member | Signature | Purpose |
| --- | --- | --- |
| `AutoPostBack` | `Public Property AutoPostBack As Boolean` | Determines whether changing the selected item immediately posts the page back to the server. |
| `Items` | `Public ReadOnly Property Items As ListItemCollection` | Collection of selectable radio-button-list items managed by the control. |
| `RepeatColumns` | `Public Property RepeatColumns As Integer` | Controls how many item columns render before the layout wraps to a new row. |
| `RepeatDirection` | `Public Property RepeatDirection As RepeatDirection` | Controls whether items lay out horizontally or vertically. |
| `RepeatLayout` | `Public Property RepeatLayout As RepeatLayout` | Chooses the HTML layout pattern used to render the item list. |
| `SelectedIndex` | `Public Property SelectedIndex As Integer` | Index of the currently selected item in the list. |
| `SelectedItem` | `Public ReadOnly Property SelectedItem As ListItem` | Currently selected radio-button-list item. |
| `SelectedValue` | `Public Property SelectedValue As String` | Value of the currently selected item. |
| `TextAlign` | `Public Property TextAlign As TextAlign` | Controls whether item labels render before or after their radio inputs. |
| `SelectedIndexChanged` | `Public Event SelectedIndexChanged As EventHandler` | Standard list-selection change event raised after postback. |

Standard `RadioButtonList`/`Control` members (`ID`, `ClientID`, `Controls`, `Visible`, `DataBind`, `FindControl`, etc.) are not re-documented here as they are unmodified framework behavior**.

## Behavioral notes
- `RenderItems` lays items into `<tr>`/`<td>` cells honoring `RepeatDirection`, mirroring `SAIFCheckBoxList`'s layout approach but without the `RepeatColumns`-based branching present in that control*.

## Constraints and usage notes
- The read-only image paths (`/Resources/Images/rb_checked.gif`, `/Resources/Images/rb_unchecked.gif`) are hardcoded and must exist in the hosting application.

> **Note:** Statements marked with * were inferred from code structure, naming conventions, or
> contextual evidence where direct confirmation was not available in source artifacts. Statements
> marked with ** could not be confirmed; treat as unknown until verified.

## Sources
- SAIF.Presentation.Web.Controls.V2\SAIFRadioButtonList.vb