.NET WebForm动态加载用户控件遇RegisterForEventValidation异常求助

背景与现有实现 #

我在.NET WebForm项目中实现动态标签菜单，标签控件在aspx文件中管理，选中标签时通过Ajax加载对应的ascx用户控件，已通过RenderControl实现控件加载。

标签切换的Ajax调用代码 #

$('a[data-bs-toggle="tab"]').on('shown.bs.tab', function (e) {
    var targetId = $(e.target).data('bs-target').substring(1);
    loadUserControl(targetId);
});

function loadUserControl(userControlId) {
    $.ajax({
        type: "POST",
        url: "Page.aspx/LoadUserControl",
        data: JSON.stringify({ userControlId: userControlId }),
        contentType: "application/json; charset=utf-8",
        dataType: "json",
        success: function (response) {
            $('#tabContent').html(response.d);
        },
        error: function (error) {
            console.log(error);
        }
    });
}

原渲染用户控件的WebMethod代码 #

[WebMethod]
public static string LoadUserControl(string userControlId)
{
    if (HttpContext.Current.Handler is Page page)
    {
        var userControl = page.LoadControl($"{userControlId}.ascx");
        using (StringWriter stringWriter = new StringWriter())
        {
            using (HtmlTextWriter htmlWriter = new HtmlTextWriter(stringWriter))
            {
                userControl.RenderControl(htmlWriter);
                return stringWriter.ToString();
            }
        }
    }
    return string.Empty;
}

遇到的问题 #

当用户控件内包含带runat="server"属性的控件（如input、asp:Button）时，会抛出异常：RegisterForEventValidation can only be called during Render。

网上常见方案是禁用用户控件的EnableEventValidation并重写VerifyRenderingInServerForm方法，但出于安全考虑不想禁用该属性，需要替代方案。

解决方案：模拟完整Page生命周期 #

问题根源在于直接调用RenderControl跳过了Page的关键生命周期阶段，导致控件无法正确注册事件验证。通过创建全新的Page实例并触发完整生命周期流程，可在保留EnableEventValidation的前提下解决问题：

[WebMethod]
public static string LoadUserControl(string userControlId)
{
    // 创建全新的Page实例，避免复用当前页面的生命周期状态
    Page tempPage = new Page();
    HtmlForm form = new HtmlForm();
    tempPage.Controls.Add(form);
    
    // 加载用户控件并添加到Form中
    var userControl = tempPage.LoadControl($"{userControlId}.ascx");
    form.Controls.Add(userControl);
    
    // 触发完整的页面生命周期，确保控件正确注册事件验证
    tempPage.ProcessRequest(HttpContext.Current);
    
    using (StringWriter stringWriter = new StringWriter())
    {
        using (HtmlTextWriter htmlWriter = new HtmlTextWriter(stringWriter))
        {
            tempPage.RenderControl(htmlWriter);
            // 提取Form内部的HTML内容，避免返回整个页面的冗余结构
            string fullHtml = stringWriter.ToString();
            int formStartIndex = fullHtml.IndexOf("<form");
            int formEndIndex = fullHtml.IndexOf("</form>") + "</form>".Length;
            
            return formStartIndex >= 0 && formEndIndex > formStartIndex 
                ? fullHtml.Substring(formStartIndex, formEndIndex - formStartIndex) 
                : string.Empty;
        }
    }
}

方案说明 #

1. 创建独立Page实例：避免使用当前请求的Page（其生命周期已过Render阶段），全新Page可完整执行生命周期流程。
2. 添加HtmlForm容器：WebForm要求服务器控件必须放在<form runat="server"内，否则会触发VerifyRenderingInServerForm相关异常。
3. 执行ProcessRequest：触发Page的Init、Load等生命周期事件，让控件在正确时机注册事件验证，无需禁用EnableEventValidation。
4. 提取Form内容：过滤掉Page生成的完整HTML结构（如html、head、body标签），只返回用户控件所在的Form内部内容，适配前端标签容器的插入需求。

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