ASP.NET RadioButton 分組技巧：GroupName 屬性完整指南

核心結論

在 ASP.NET 中實現 RadioButton 單選互斥，只需為同組控件設置相同的 GroupName 屬性值即可。這比傳統 HTML 的 name 屬性更靈活，支援跨命名容器、Repeater/GridView 模板列等複雜場景。

基本用法

<asp:RadioButton ID="radOption1" runat="server" Text="選項一" GroupName="GroupA" />
<asp:RadioButton ID="radOption2" runat="server" Text="選項二" GroupName="GroupA" />
<asp:RadioButton ID="radOption3" runat="server" Text="選項三" GroupName="GroupA" />

進階場景：數據綁定控件中的分組

在 Repeater、GridView、ListView 等模板中，為每行生成獨立分組：

<asp:Repeater ID="rptTemplates" runat="server">
    <ItemTemplate>
        <asp:RadioButton 
            ID="radTemplate" 
            runat="server" 
            Text='<%# Eval("Template_Name") %>' 
            GroupName='<%# "Group_" + Eval("ID") %>' 
            ToolTip='<%# Eval("ID") %>' />
    </ItemTemplate>
</asp:Repeater>

關鍵點解析

• 動態 GroupName：使用 "Group_" + Eval("ID") 確保每行數據的單選框互斥，不同行互不影響
• ToolTip 攜帶 ID：方便前端 JS 或後端獲取選中項的業務主鍵
• 自動生成 name：ASP.NET 會根據 GroupName 渲染為同名 input[type=radio]，瀏覽器原生實現互斥

後端獲取選中值

// 遍歷 Repeater 項查找選中項
foreach (RepeaterItem item in rptTemplates.Items)
{
    var rb = item.FindControl("radTemplate") as RadioButton;
    if (rb?.Checked == true)
    {
        int templateId = int.Parse(rb.ToolTip);
        // 處理業務邏輯
        break;
    }
}

常見坑點與避坑指南

總結

GroupName 是 ASP.NET RadioButton 分組的核心屬性，靈活運用動態綁定可滿足各類列表單選需求。記住：同組同名，異組異名，配合命名容器隔離，即可輕鬆實現複雜單選交互。