C# WinForm动态加载用户控件间的数据传递问题

阿华AIGC实验室

2026-5-9

解决用户控件间的文本传递问题

我看了你的代码，核心问题有两个：一是ucSecond在Form1_Load里是局部变量，导致你在TextAvailableFromUcFirst事件处理方法里拿不到它的实例；二是直接访问用户控件内部的文本框违反了封装原则，而且你给控件添加到面板时没设置Name，Controls["UC_2"]可能根本找不到目标控件。

下面是修改后的完整方案：

第一步：调整Form1代码，保存用户控件实例并设置Name

把ucFirst和ucSecond改成Form的私有成员变量，这样在事件处理里能直接访问；同时给控件设置Name属性，确保BringToFront能正常工作：

public partial class Form1 : Form
{
    public Form1()
    {
        InitializeComponent();
    }
    private static Form1 _obj;
    public static Form1 Instance
    {
        get
        {
            if (_obj == null)
                _obj = new Form1();
            return _obj;
        }
    }

    // 把用户控件改成成员变量，方便后续访问
    private UC_1 _ucFirst;
    private UC_2 _ucSecond;

    private void Form1_Load(object sender, EventArgs e)
    {
        _obj = this;
        //create first user control instance
        _ucFirst = new UC_1();
        _ucFirst.Dock = DockStyle.Fill;
        _ucFirst.Name = "UC_1"; // 设置Name，确保Controls能找到
        mainPanel.Controls.Add(_ucFirst);
        //create second user control instance
        _ucSecond = new UC_2();
        _ucSecond.Dock = DockStyle.Fill;
        _ucSecond.Name = "UC_2"; // 设置Name
        mainPanel.Controls.Add(_ucSecond);
        //Subscribe to events
        _ucFirst.TextEntered += TextAvailableFromUcFirst;
    }
    private void TextAvailableFromUcFirst(object sender, string availableText)
    {
        // 直接用成员变量访问ucSecond，通过公共方法设置文本
        _ucSecond.SetTextBoxText(availableText);
    }
    private void showFirstUcBtn_Click(object sender, EventArgs e)
    {
        mainPanel.Controls["UC_1"].BringToFront();
    }

    // 可选：添加显示第二个控件的按钮方法
    private void showSecondUcBtn_Click(object sender, EventArgs e)
    {
        mainPanel.Controls["UC_2"].BringToFront();
    }
}

第二步：给UC_2添加公共方法，封装文本设置

不要直接让外部访问用户控件内部的文本框，这是不好的编程习惯。我们给UC_2加一个公共方法来设置文本：

public partial class UC_2 : UserControl
{
    public UC_2()
    {
        InitializeComponent();
    }

    // 公共方法，用于设置内部文本框的内容
    public void SetTextBoxText(string text)
    {
        textBoxUcSecond.Text = text;
    }
}

第三步：简化UC_1的代码（优化单例逻辑）

UC_1里的单例其实没必要，因为你已经在Form里创建了实例并订阅了事件。调整后的代码如下：

public delegate void TextEventHandler(object sender, string text);
public partial class UC_1 : UserControl
{
    public UC_1()
    {
        InitializeComponent();
    }

    //Create an event
    public event TextEventHandler TextEntered;
    protected virtual void OnTextEntered(string text)
    {
        TextEntered?.Invoke(this, text);
    }
    private void firstUcBtn_Click(object sender, EventArgs e)
    {
        string textBoxText = textBoxUcFirst.Text;
        OnTextEntered(textBoxText);
        // 现在可以正确找到UC_2了，因为我们设置了Name
        Form1.Instance.mainPanel.Controls["UC_2"].BringToFront();
    }
}