WinForms单实例程序：启动新实例时如何更新已有窗体TextBox控件

我来帮你搞定这个问题～单实例应用里，第二个进程没办法直接访问第一个进程的窗体对象，所以得靠跨进程通信来通知已有实例更新TextBox。下面是一步步的具体实现，亲测可行：

1. 给主窗体添加安全更新控件的方法 #

首先在FormMain里加一个公共方法，处理跨线程更新控件的情况（因为跨进程消息可能在非UI线程触发，直接操作控件会报错）：

public void UpdateTextBoxAndActivate(string newText)
{
    // 判断是否需要跨线程调用
    if (textBox1.InvokeRequired)
    {
        textBox1.Invoke(new Action<string>(UpdateTextBoxAndActivate), newText);
        return;
    }

    // 更新TextBox并激活窗体
    textBox1.Text = newText;
    this.WindowState = FormWindowState.Normal; // 如果窗体最小化就还原
    this.BringToFront();
    this.Activate();
}

2. 引入Windows API实现跨进程消息传递 #

我们用系统自带的WM_COPYDATA消息来传递数据，这是一种简单且可靠的跨进程通信方式。先在项目里添加API声明：

using System.Runtime.InteropServices;

public static class Win32Api
{
    public const int WM_COPYDATA = 0x004A; // 系统定义的消息ID

    // 用于传递数据的结构体
    [StructLayout(LayoutKind.Sequential)]
    public struct COPYDATASTRUCT
    {
        public IntPtr dwData; // 自定义数据，这里用不到可以设为0
        public int cbData;    // 要传递的字符串长度（包含终止符）
        [MarshalAs(UnmanagedType.LPStr)]
        public string lpData; // 要传递的文本内容
    }

    // 根据窗体标题查找窗口句柄
    [DllImport("user32.dll", SetLastError = true)]
    public static extern IntPtr FindWindow(string lpClassName, string lpWindowName);

    // 发送消息到目标窗口
    [DllImport("user32.dll", SetLastError = true)]
    public static extern bool SendMessage(IntPtr hWnd, uint Msg, IntPtr wParam, ref COPYDATASTRUCT lParam);
}

3. 修改Main方法，处理实例冲突时的通知逻辑 #

当检测到已有实例存在时，找到主窗体的句柄，然后通过WM_COPYDATA把要更新的文本传过去：

static void Main(string[] args)
{
    bool result;
    Mutex mutex = new System.Threading.Mutex(true, "unique_name", out result);

    if (!result)
    {
        // 这里可以根据需求拼接要传递的文本，比如用启动参数
        string updateContent = args.Length > 0 ? string.Join(" ", args) : "收到新的更新请求";
        
        // 查找主窗体，这里替换成你FormMain的实际标题
        IntPtr mainWindowHandle = Win32Api.FindWindow(null, "FormMain");
        if (mainWindowHandle != IntPtr.Zero)
        {
            Win32Api.COPYDATASTRUCT dataStruct = new Win32Api.COPYDATASTRUCT();
            dataStruct.dwData = IntPtr.Zero;
            dataStruct.lpData = updateContent;
            dataStruct.cbData = updateContent.Length + 1; // 要包含字符串终止符

            // 发送消息
            Win32Api.SendMessage(mainWindowHandle, Win32Api.WM_COPYDATA, IntPtr.Zero, ref dataStruct);
        }
        return;
    }

    Application.EnableVisualStyles();
    Application.SetCompatibleTextRenderingDefault(true);
    Application.Run(new FormMain(args));
    GC.KeepAlive(mutex);
}

4. 在FormMain中捕获并处理消息 #

最后，重写WndProc方法，捕获WM_COPYDATA消息并调用我们之前写的更新方法：

protected override void WndProc(ref Message m)
{
    if (m.Msg == Win32Api.WM_COPYDATA)
    {
        // 解析传递过来的数据
        Win32Api.COPYDATASTRUCT receivedData = 
            (Win32Api.COPYDATASTRUCT)Marshal.PtrToStructure(m.LParam, typeof(Win32Api.COPYDATASTRUCT));
        
        // 更新TextBox并激活窗体
        UpdateTextBoxAndActivate(receivedData.lpData);
        
        m.Result = (IntPtr)1; // 告诉系统我们已经成功处理了消息
        return;
    }
    base.WndProc(ref m);
}

小提示 #

• 如果不想依赖窗体标题来查找窗口，可以用窗体的类名。你可以先在FormMain的构造函数里用GetClassName API获取类名，然后替换FindWindow的第一个参数。
• WM_COPYDATA会自动处理内存的安全传递，不用担心数据在传递过程中被释放。
• 一定要处理InvokeRequired，否则跨线程操作控件会抛出异常哦～

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