如何在ASPX页面中动态加载用户控件？附示例代码

嘿，这个需求在ASP.NET开发里挺常见的，我给你梳理几种靠谱的实现方式，一步步来：

首先，你需要在choosemenu.aspx的后台代码（也就是choosemenu.aspx.cs）里编写加载逻辑。核心是用LoadControl方法加载用户控件，然后把它添加到renderhere这个服务器端容器的控件集合里。

比如在Page_Load事件里加载english.ascx：

protected void Page_Load(object sender, EventArgs e)
{
    // 加载指定路径的用户控件
    var englishControl = LoadControl("~/english.ascx");
    // 一定要给控件设置唯一ID！这关系到回发时的状态跟踪和事件触发
    englishControl.ID = "EnglishUC1";
    // 将控件添加到目标容器中
    renderhere.Controls.Add(englishControl);
}

如果需要让用户选择加载哪个控件（比如通过下拉框或按钮触发），可以这么做：

首先在choosemenu.aspx的前端加个选择控件和触发按钮：

<div>
    <asp:DropDownList ID="ddlSubjects" runat="server">
        <asp:ListItem Text="English" Value="english"></asp:ListItem>
        <asp:ListItem Text="Commerce" Value="commerce"></asp:ListItem>
        <asp:ListItem Text="Maths" Value="maths"></asp:ListItem>
    </asp:DropDownList>
    <asp:Button ID="btnLoadControl" runat="server" Text="Load Selected Control" OnClick="btnLoadControl_Click" />
</div>

然后在后台写按钮点击的处理逻辑：

protected void btnLoadControl_Click(object sender, EventArgs e)
{
    // 先清空容器里已有的控件，避免重复加载
    renderhere.Controls.Clear();

    string controlPath = string.Empty;
    // 根据用户选择确定要加载的控件路径
    switch (ddlSubjects.SelectedValue)
    {
        case "english":
            controlPath = "~/english.ascx";
            break;
        case "commerce":
            controlPath = "~/commerce.ascx";
            break;
        case "maths":
            controlPath = "~/maths.ascx";
            break;
        default:
            // 没有有效选择时，添加提示
            var tipLabel = new Label();
            tipLabel.Text = "请选择一个有效的科目";
            renderhere.Controls.Add(tipLabel);
            return;
    }

    // 加载控件并设置唯一ID
    var targetControl = LoadControl(controlPath);
    targetControl.ID = $"{ddlSubjects.SelectedValue}UC";
    // 添加到目标容器
    renderhere.Controls.Add(targetControl);
}

这些细节很重要，不然容易踩坑：

• 必须设置控件ID：如果不给动态加载的控件设置唯一ID，ASP.NET无法跟踪它的ViewState和事件，回发后控件会丢失，或者控件里的按钮点击事件根本触发不了。
• 回发时重新加载：动态加载的控件不会自动保存到ViewState，所以如果页面有回发操作（比如点击控件里的按钮），需要在Page_Init或Page_Load里重新加载对应的控件。可以把当前加载的控件路径存在ViewState里，示例如下：

  protected void Page_Load(object sender, EventArgs e)
  {
      // 回发时重新加载之前的控件
      if (IsPostBack && ViewState["LoadedControlPath"] != null)
      {
          string savedPath = ViewState["LoadedControlPath"].ToString();
          var reloadedControl = LoadControl(savedPath);
          reloadedControl.ID = $"{Path.GetFileNameWithoutExtension(savedPath)}UC";
          renderhere.Controls.Add(reloadedControl);
      }
  }
  
  protected void btnLoadControl_Click(object sender, EventArgs e)
  {
      // ... 之前的加载代码 ...
      // 把当前加载的控件路径保存到ViewState
      ViewState["LoadedControlPath"] = controlPath;
  }
  

• 路径要正确：用~/开头表示网站根目录，避免相对路径出错（比如控件在子文件夹里，路径就写成~/Controls/english.ascx）。
• 处理控件事件：如果需要响应用户控件里的自定义事件，要先把加载的控件强转成对应的类型，再绑定事件。比如假设english.ascx有个OnSubmit事件：

  // 强转成控件的具体类型（前提是你已经在后台引用了控件的命名空间）
  var englishControl = (EnglishUC)LoadControl("~/english.ascx");
  // 绑定事件
  englishControl.OnSubmit += EnglishControl_OnSubmit;
  renderhere.Controls.Add(englishControl);
  
  // 事件处理方法
  private void EnglishControl_OnSubmit(object sender, EventArgs e)
  {
      // 这里写你的事件处理逻辑
      Response.Write("English控件的提交事件触发了！");
  }
  

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