如何向运行中的WPF应用传递命令行参数并触发响应

云原生阿岚

2026-8-26

该需求完全可以实现。核心思路是将程序改造为单实例模式，搭配跨进程通信机制：后续启动的新进程检测到已有实例运行时，不创建新的程序窗口/进程，直接把收到的命令行参数传递给已在运行的旧实例，新进程自行退出即可，旧实例收到参数后执行对应响应逻辑，你原本启动不显示窗口的逻辑不会受到任何影响。

以下是两种常用的落地实现方案：

方案1：内置类快速实现（推荐，代码量最少）

借助Microsoft.VisualBasic.ApplicationServices下的WindowsFormsApplicationBase类实现，该类原生封装了单实例检测和启动参数传递能力，WPF项目可直接引用，不需要引入第三方包。

首先给项目添加程序集引用：勾选引用System.Windows.Forms和Microsoft.VisualBasic。

自定义单实例包装类，重写启动和后续实例启动的逻辑：

using Microsoft.VisualBasic.ApplicationServices;
using System.Collections.Generic;
using System.Windows;

public class SingleInstanceApp : WindowsFormsApplicationBase
{
    private App _wpfApp;
    public SingleInstanceApp()
    {
        // 开启单实例模式
        IsSingleInstance = true;
    }

    // 首个实例启动时触发，初始化WPF应用
    protected override bool OnStartup(StartupEventArgs eventArgs)
    {
        _wpfApp = new App();
        _wpfApp.InitializeComponent();
        _wpfApp.Run();
        return false;
    }

    // 后续新实例启动时触发，将参数传递给已运行的首个实例
    protected override void OnStartupNextInstance(StartupNextInstanceEventArgs eventArgs)
    {
        List<string> receivedArgs = new List<string>(eventArgs.CommandLine);
        // 调用WPF App层自定义的参数处理方法
        _wpfApp.ProcessNewCommandArgs(receivedArgs);
    }
}

修改原有的Main入口方法，启动单实例包装类而非直接启动WPF App：

[STAThread]
static void Main(string[] args)
{
    SingleInstanceApp instanceApp = new SingleInstanceApp();
    instanceApp.Run(args);
}

在App.xaml.cs中添加参数处理方法，实现收到参数后的业务逻辑：

public void ProcessNewCommandArgs(List<string> args)
{
    // 此处编写参数响应逻辑，比如弹通知、执行后台操作等，不需要强制显示窗口
    MessageBox.Show($"收到传入参数：{string.Join(",", args)}");
}

注意：使用该方案时需要把App.xaml的生成操作从ApplicationDefinition改为Page，避免编译器自动生成重复的Main入口导致编译报错，同时删除App.xaml中配置的StartupUri属性，防止重复创建主窗口。

方案2：命名管道自定义实现（无额外依赖，自由度高）

如果不想引入WinForms、VB相关的程序集，可以用互斥锁（Mutex）做单实例检测，搭配命名管道做跨进程参数传递，所有逻辑都可以自主控制。

首先引入需要的命名空间：System.IO.Pipes、System.Threading。

修改Main方法，加入单实例检测逻辑：

[STAThread]
static void Main(string[] args)
{
    // 互斥锁名称建议加项目专属前缀，避免和其他软件冲突
    Mutex appMutex = new Mutex(true, "MyWpfApp_UniqueMutex_2024", out bool isFirstInstance);
    if (isFirstInstance)
    {
        // 首个实例：初始化WPF应用，启动命名管道监听
        App app = new App();
        app.InitializeComponent();
        // 后台线程启动管道监听，避免阻塞UI
        Task.Run(StartNamedPipeListener);
        app.Run();
        GC.KeepAlive(appMutex);
    }
    else
    {
        // 已有实例运行：将参数通过管道发送给旧实例后退出
        SendArgsToRunningInstance(args);
        return;
    }
}

实现命名管道服务端监听逻辑，在首个实例中持续接收参数：

// 管道名称同样要保证全局唯一
private const string PipeName = "MyWpfApp_UniquePipe_2024";
private static void StartNamedPipeListener()
{
    while (true)
    {
        using (NamedPipeServerStream pipeServer = new NamedPipeServerStream(PipeName, PipeDirection.In))
        {
            pipeServer.WaitForConnection();
            using (StreamReader reader = new StreamReader(pipeServer))
            {
                string rawArgsStr = reader.ReadToEnd();
                // 用特殊分隔符拆分参数，避免参数内容本身带逗号产生拆分错误
                List<string> receivedArgs = rawArgsStr.Split(new[] { "|||" }, StringSplitOptions.None).ToList();
                // 切回UI线程处理参数
                Application.Current.Dispatcher.Invoke(() =>
                {
                    ((App)Application.Current).ProcessNewCommandArgs(receivedArgs);
                });
            }
        }
    }
}

实现新实例的参数发送逻辑：

private static void SendArgsToRunningInstance(string[] args)
{
    using (NamedPipeClientStream pipeClient = new NamedPipeClientStream(".", PipeName, PipeDirection.Out))
    {
        try
        {
            pipeClient.Connect(1000); // 设置1秒连接超时
            using (StreamWriter writer = new StreamWriter(pipeClient))
            {
                writer.Write(string.Join("|||", args));
                writer.Flush();
            }
        }
        catch
        {
            // 可自行添加连接失败的容错逻辑
        }
    }
}

该方案下的ProcessNewCommandArgs方法和方案1完全一致，直接复用即可。

补充说明

两种方案都不会影响你原本启动隐藏窗口的逻辑，是否显示窗口、如何响应参数完全由你自定义的业务代码控制。
如果程序需要跨权限运行（比如已运行的实例是管理员权限，新启动的是普通用户权限），需要给命名管道配置对应的安全访问规则，普通桌面场景下上述代码可直接运行。

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

如何向运行中的WPF应用传递命令行参数并触发响应

方案1：内置类快速实现（推荐，代码量最少） #

方案2：命名管道自定义实现（无额外依赖，自由度高） #

补充说明 #

方案1：内置类快速实现（推荐，代码量最少）

方案2：命名管道自定义实现（无额外依赖，自由度高）

补充说明