如何在ASPX页面（非代码后置）正确绑定用户控件EventHandler

问题根源 #

1. ASP.NET页面解析器默认不会自动识别未标注特性的自定义事件，无法完成声明式绑定。
2. 你在ASPX页面中直接使用SelectedIndexChanged作为属性名绑定事件，不符合ASP.NET声明式事件绑定的规范（标准写法是On[EventName]）。
3. 不必要的Page_Load全局调用DataBind()可能干扰事件绑定生命周期。

修复步骤 #

1. 修正ASPX页面的事件绑定语法 #

将ASPX中的SelectedIndexChanged改为OnSelectedIndexChanged，符合ASP.NET声明式事件绑定的标准写法：

<CustomControl:Dropdown 
    runat="server" 
    ID="DropdownOne" 
    OnSelectedIndexChanged="DropdownOne_SelectedIndexChanged"
>
...
</CustomControl:Dropdown>

2. 为自定义事件添加识别特性 #

在用户控件的事件上添加Browsable和Category特性，让ASP.NET页面解析器能够识别并支持声明式绑定：

using System.ComponentModel;

public partial class Dropdown : UserControl 
{
    [Browsable(true)]          // 允许在设计器中显示该事件
    [Category("Action")]       // 将事件归类到"操作"分组
    [Description("下拉列表选中项改变时触发")]
    public event EventHandler SelectedIndexChanged; // 使用内置EventHandler，无需自定义委托

    protected void Page_Load(object sender, EventArgs e) 
    {
        if (!IsPostBack)       // 仅首次加载时绑定数据，避免重置选中项
        {
            DataBind();
        }
    }

    protected void dropDown_SelectedIndexChanged(object sender, EventArgs e) 
    {
        SelectedIndexChanged?.Invoke(sender, e); // 空合并运算符简化null判断
    }   
}

3. 确保内嵌DropDownList的配置正确 #

检查用户控件内的asp:DropDownList，确认开启AutoPostBack并正确绑定内部事件：

<asp:DropDownList ID="dropDown" runat="server" AutoPostBack="true" OnSelectedIndexChanged="dropDown_SelectedIndexChanged">
    <!-- 列表项定义 -->
</asp:DropDownList>

4. 确认用户控件的AutoEventWireup设置 #

检查Dropdown.ascx顶部的指令，确保AutoEventWireup="true"（默认值，但避免被手动修改）：

<%@ Control Language="C#" AutoEventWireup="true" CodeFile="Dropdown.ascx.cs" Inherits="Dropdown" %>

验证效果 #

完成以上修改后，ASPX页面的声明式事件绑定将正常生效，无需在代码后置中手动添加+=绑定语句，SelectedIndexChanged事件会在页面生命周期中被正确赋值，触发时能正常调用页面中的处理方法。

内容的提问来源于stack exchange，提问作者Battle J. Butts