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

# SAIFRadioButton

`SAIFRadioButton` is a `RadioButton` subclass mirroring `SAIFCheckBox`'s `[ReadOnly]` static-image rendering convention for radio buttons: a visually-hidden native radio button preserves `ViewState`, while a static checked/unchecked image and label render in its place ([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 buttons across the SAIF UI, matching `SAIFCheckBox`'s pattern.

## 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 `RadioButton` rendering to the static image + hidden-radio-button convention, per [BR-V2-003](../../business-rules.md#br-v2-003-read-only-input-controls-render-as-static-images-not-native-controls). |

## Inherited public members

`SAIFRadioButton` inherits from `RadioButton` (`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 radio button immediately posts the page back to the server. |
| `Checked` | `Public Property Checked As Boolean` | Current selected state of the radio button. |
| `GroupName` | `Public Property GroupName As String` | Groups related radio buttons so only one can be selected at a time in the browser. |
| `InputAttributes` | `Public ReadOnly Property InputAttributes As AttributeCollection` | Additional HTML attributes rendered on the underlying `<input>` element. |
| `Text` | `Public Property Text As String` | Label text rendered alongside the radio button. |
| `TextAlign` | `Public Property TextAlign As TextAlign` | Controls whether the label renders before or after the radio button input. |
| `ValidationGroup` | `Public Property ValidationGroup As String` | Validator group name evaluated when the radio button participates in validation-triggering postbacks. |
| `CheckedChanged` | `Public Event CheckedChanged As EventHandler` | Standard change event raised after the selected state changes on postback. |

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

## Behavioral notes
- `Render` positions the hidden native radio button off-screen so its posted value is preserved, then renders `rb_checked.gif`/`rb_unchecked.gif` alongside the label per `TextAlign`.

## 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\SAIFRadioButton.vb