为何C#中FindControl无法获取ASPX页面控件并返回null？

为什么FindControl返回null？ #

• 控件不在Page直接子层级：Page.FindControl()仅查找Page的直接子控件，若Repeater1嵌套在Panel、ContentPlaceHolder或用户控件这类容器中，直接调用Page的FindControl无法找到它——该方法不会递归遍历所有子控件层级。
• 调用时机过早：若在页面生命周期早期（如Page_Init阶段）调用FindControl，此时控件还未完成初始化，必然返回null。
• Page实例错误：公共文件中的Page对象若未指向当前请求页面的真实实例，也会导致查找失败。

解决步骤 #

1. 用递归方法遍历查找控件 #

写一个递归辅助方法，遍历所有控件层级定位目标控件：

public static Control FindControlRecursive(Control parent, string controlId)
{
    if (parent.ID == controlId)
        return parent;
    
    foreach (Control child in parent.Controls)
    {
        Control foundControl = FindControlRecursive(child, controlId);
        if (foundControl != null)
            return foundControl;
    }
    return null;
}

在公共函数中调用该方法：

mycontrol = (global::System.Web.UI.WebControls.Repeater)FindControlRecursive(Page, "Repeater1");
if(mycontrol != null)
{
    mycontrol.DataSource = message;
    mycontrol.DataBind(); // 必须添加DataBind()，否则数据不会渲染到控件上
}

2. 确保调用时机正确 #

将调用公共函数的代码放在Page_Load事件之后，或Page_InitComplete事件中，保证页面所有控件已完成初始化。

3. 传递正确的Page实例 #

若公共函数在独立类中，需将当前页面的Page对象作为参数传入，避免依赖类内部错误的Page引用：

// 公共函数定义
public static void BindRepeater(Page currentPage, object message)
{
    var mycontrol = (Repeater)FindControlRecursive(currentPage, "Repeater1");
    if(mycontrol != null)
    {
        mycontrol.DataSource = message;
        mycontrol.DataBind();
    }
}

// 页面中调用
YourCommonClass.BindRepeater(this, message);

额外场景：母版页下的控件查找 #

若页面使用母版页，Repeater1通常在ContentPlaceHolder内，可先定位容器再查找控件：

ContentPlaceHolder cph = (ContentPlaceHolder)Page.Master.FindControl("ContentPlaceHolder1");
Repeater mycontrol = (Repeater)cph.FindControl("Repeater1");

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