C#自定义ListView类中复用父窗体TextBox引用的最优方法

这个需求很常见，最优的做法就是在自定义ListView类内部缓存目标TextBox的引用，只在控件创建完成时初始化一次，之后在类的任意方法里直接复用即可。既避免了重复查找控件的冗余代码，也能让代码更简洁高效。

具体实现步骤： #

1. 添加私有字段存储引用
   首先在自定义ListView类里声明一个私有TextBox字段，用来保存找到的目标控件引用，保证只有类内部能访问，符合封装原则：

   private TextBox _targetTextBox;
   

2. 重写OnCreateControl()初始化引用
   OnCreateControl()是控件完成创建、加入控件树后触发的方法，这时候调用FindForm()能可靠获取到所在窗体（比构造函数里查找更安全，因为构造阶段控件还没关联到窗体）。在这里完成一次查找并赋值：

   protected override void OnCreateControl()
   {
       base.OnCreateControl();
   
       // 跳过设计器模式，避免设计时出现不必要的错误
       if (!DesignMode && FindForm() != null)
       {
           // 查找目标TextBox并转换类型
           var textControl = FindForm().Controls.Find("Textbox1", true).FirstOrDefault() as TextBox;
           _targetTextBox = textControl;
   
           // 可选：添加调试提示，方便排查找不到控件的情况
           if (_targetTextBox == null)
           {
               System.Diagnostics.Debug.WriteLine("警告：未找到名为Textbox1的TextBox控件");
           }
       }
   }
   

3. 在类内复用引用
   之后在自定义ListView的任意方法里，直接使用_targetTextBox即可，记得加空引用检查避免异常：

   // 示例：更新TextBox文本的方法
   public void UpdateTextBox(string newText)
   {
       // 用空条件运算符?.避免空引用异常
       _targetTextBox?.Text = newText;
   }
   
   // 内部方法中使用示例
   private void HandleListViewEvent()
   {
       if (_targetTextBox != null)
       {
           string currentContent = _targetTextBox.Text;
           // 执行你的业务逻辑...
       }
   }
   

进阶优化建议： #

如果希望控件更灵活（比如允许使用者自定义目标TextBox的名称，而非硬编码），可以添加一个公共属性来配置：

// 可配置的目标TextBox名称，默认值为Textbox1
public string TargetTextBoxName { get; set; } = "Textbox1";

protected override void OnCreateControl()
{
    base.OnCreateControl();

    if (!DesignMode && FindForm() != null && !string.IsNullOrEmpty(TargetTextBoxName))
    {
        var textControl = FindForm().Controls.Find(TargetTextBoxName, true).FirstOrDefault() as TextBox;
        _targetTextBox = textControl;
    }
}

这样使用者可以在Visual Studio的属性窗口直接设置TargetTextBoxName，不用修改控件代码，扩展性更好。

关键注意事项： #

• 设计器模式判断：必须加上!DesignMode，否则在窗体设计界面时，控件会尝试查找运行时才存在的控件，导致设计器报错。
• 空引用保护：无论初始化还是使用阶段，都要检查_targetTextBox是否为null，避免空引用异常（比如窗体上确实没有这个控件的情况）。
• 时机选择：不要在构造函数中查找窗体控件，因为构造时控件还没被添加到窗体的控件树，FindForm()会返回null。

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