如何在经典ASP.NET中实现UserControl的RenderPartial并仅返回控件内容到浏览器

问题核心原因 #

你的实现返回完整页面内容，是因为直接将控件挂载到空白Page实例根节点后，触发了Page的完整页面生成逻辑，同时直接实例化用户控件的方式无法完整执行控件生命周期，也不能正确关联ascx文件的标记内容。

代码修改方案 #

1. 重写基类GetHtml方法 #

using System.Text;
using System.IO;
using System.Web.UI;
using System.Web.UI.HtmlControls;

public class RenderingControl : System.Web.UI.UserControl
{
    public string GetHtml(Type ControlType, int id1)
    {
        var page = new Page();
        // 禁用事件验证，避免服务端控件渲染报错
        page.EnableEventValidation = false;
        page.ViewStateMode = ViewStateMode.Disabled;
        
        // 新增空白Form容器，避免Page生成html/body等全局标签
        var emptyForm = new HtmlForm();
        page.Controls.Add(emptyForm);

        // 加载用户控件并传入参数
        var control = page.LoadControl(ControlType, new object[] { id1 });
        emptyForm.Controls.Add(control);

        // 执行控件完整生命周期，确保Page_Load等事件正常触发
        page.ProcessRequest(HttpContext.Current);

        // 仅捕获控件本身的渲染结果
        var sb = new StringBuilder();
        using (var sw = new StringWriter(sb))
        using (var htmlWriter = new HtmlTextWriter(sw))
        {
            control.RenderControl(htmlWriter);
        }
        return sb.ToString();
    }
}

2. 优化WebMethod调用逻辑 #

不需要预先实例化目标用户控件，直接传入控件类型即可：

[WebMethod()]
public string Filters(string type, int id) {
    var renderHelper = new RenderingControl();
    return renderHelper.GetHtml(typeof(FilterStatus), id);
}

额外注意事项 #

• 优先使用LoadControl的路径重载（传入.ascx文件的站点相对路径，例如page.LoadControl("~/UserControls/FilterStatus.ascx")），兼容性更强，可避免Type重载可能出现的控件标记未加载问题。
• 如果你的用户控件中没有服务端表单控件，也可以跳过添加HtmlForm的步骤，直接把控件挂载到Page后渲染。
• 控件内部通过ClientScript注册的脚本、样式不会被自动携带，如有需要要单独处理资源引用。

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