ASP.NET动态加载RadioButtonList回发时选中项丢失问题排查

问题描述 #

• 页面静态定义RadioButtonList控件，通过数据库动态加载选项，每次触发PostBack回发时，用户选中状态消失，默认选中第一个动态加载的选项。
• 复现规则：控件包含Test1、Test2、Test3三个选项，选中Test2后点击按钮触发回发，页面重载后默认变回选中Test1。

原始实现代码 #

前端aspx代码 #

<body>
    <form id="form1" runat="server">
        <asp:Literal ID="ltlQues" runat="server"></asp:Literal>
            <asp:RadioButtonList ID="RadioButtonList1" runat="server" Height="32px" Width="334px">
                <asp:ListItem>Test1</asp:ListItem>
                <asp:ListItem>Test2</asp:ListItem>
                <asp:ListItem>Test3</asp:ListItem>
            </asp:RadioButtonList>
        <asp:Button ID="Button1" runat="server" Text="Vote" BorderStyle="Groove" OnClick="Button1_Click" Height="26px" Width="60px" />
        <asp:HiddenField ID="QuestionId" runat="server" />
    </form>
</body>

后端C#代码 #

/// <summary>
/// 页面加载逻辑
/// </summary>
protected void Page_Load(object sender, EventArgs e)
{
    if (!IsPostBack)
    {
        Session["userid"] = "123";
        loadPoll();
    }
}

/// <summary>
/// 加载生效的投票内容
/// </summary>
private void loadPoll()
{
    try
    {
        ListItem li;
        SqlDataAdapter adaQuestionAndAnswers = dbObj.getAdapter("SelectQuestion");
        DataSet dsResults = new DataSet();
        adaQuestionAndAnswers.Fill(dsResults);

        
        bool isQuesionDataFilled = false;
        DataTable dt = dsResults.Tables[0];
        foreach (DataRow row in dt.Rows)
        {
            if (!isQuesionDataFilled)
            {
                    ltlQues.Text = row["QuestionText"].ToString();
                    QuestionId.Value = row["QuestionID"].ToString();
                    isQuesionDataFilled = true;
            }
            // 向RadioButtonList添加答案选项
            li = new ListItem();
            li.Text = row["AnswerText"].ToString();
            li.Value = row["QuestionID"].ToString();
            li.Attributes.Add("group", "contestants");
            RadioButtonList1.Items.Add(li);
        }
    }
    catch (Exception ex)
    {
        // 记录错误
        Response.Write(ex.Message);
    }
}

// 投票按钮点击逻辑
protected void Button1_Click(object sender, EventArgs e)
{
    try
    {
        Response.Write(RadioButtonList1.SelectedItem.Text);
    }
    catch (Exception ex)
    {
        Response.Write(ex.Message);
    }
}

问题根因 #

• 选项Value重复：动态生成ListItem时，所有选项的Value都被赋值为同一个问题IDrow["QuestionID"]，同一道题下所有答案对应的问题ID完全一致，导致所有选项的Value属性重复。ASP.NET WebForm回发时通过表单提交的选中值匹配列表项Value还原选中状态，当多个项Value相同时，会默认选中第一个匹配项，因此回发后永远选中第一个选项。
• 静态测试项未清理：aspx代码中静态写死了Test1、Test2、Test3三个测试用ListItem，动态加载数据库选项前没有清空原有项集合，导致选项重复，进一步干扰选中状态的匹配逻辑。

修复方案 #

1. 清理静态测试项：直接删除aspx中RadioButtonList内静态定义的三个ListItem，或在动态绑定选项前调用清空方法，避免重复项：

// 在loadPoll()遍历数据表加载选项前，先清空原有项
RadioButtonList1.Items.Clear();

2. 修正选项Value赋值逻辑：使用唯一的答案标识作为ListItem的Value（根据实际数据库字段调整，一般为答案表主键AnswerID），保证每个选项的Value全局唯一：

// 错误写法：所有项Value重复
// li.Value = row["QuestionID"].ToString();
// 正确写法：替换为存储答案唯一标识的字段
li.Value = row["AnswerID"].ToString();

3. 保持现有Page_Load中的绑定逻辑不变，loadPoll()仅在首次加载（!IsPostBack判断内）调用即可，不需要每次回发重新绑定，RadioButtonList默认开启ViewState会自动保存选项和选中状态。

内容的提问来源于stack exchange，提问作者Sams