ClickOnce参数传递失效：如何向ClickOnce传参并在WinForm Label显示？

Hey there! Let's figure out why your ClickOnce parameter passing isn't working and get that value showing up in your WinForm Label. I've helped tons of folks with this exact issue, so let's break down the common pitfalls and fixes step by step.

This is the #1 mistake people make—if you don't enable parameter passing in the publish config, your app will never see the parameters. Here's how to confirm:

• Open your WinForm project in Visual Studio.
• Go to Project Properties → Publish tab.
• Click the Options button (usually near the bottom right).
• Select Deployment from the left menu.
• Make sure the checkbox labeled Allow URL parameters to be passed to the application is checked.
• Save your settings and republish the app. Without this, any parameters you send get discarded immediately.

The way you pass parameters depends on how you launch the ClickOnce app:

For Web/URL Launches #

Append your parameters as a query string to the .application URL, like this:
http://your-deploy-url/YourApp.application?message=HelloFromClickOnce

For Local ClickOnce Launches #

If you're launching from a local .application file or shortcut:

• Right-click the .application file → Create shortcut.
• Right-click the shortcut → Properties.
• In the Target field, add your parameters after the path to the .application file. Make sure the path is in quotes, and parameters are outside:
  "C:\Path\To\YourApp.application" message=HelloLocal
• Click OK and launch the app via this shortcut. Note: Double-clicking the cached EXE directly won't work—you have to use the .application file or its shortcut.

You can't use Environment.GetCommandLineArgs() for ClickOnce-deployed apps (that works for regular EXEs, but ClickOnce handles parameters differently). Instead, use the ApplicationDeployment class to get the activation URI and parse its query string.

For .NET Framework Apps: #

Add this code to your Form's Load event (or wherever you want to set the Label text):

private void Form1_Load(object sender, EventArgs e)
{
    // Check if we're running as a ClickOnce deployed app
    if (ApplicationDeployment.IsNetworkDeployed)
    {
        var activationUri = ApplicationDeployment.CurrentDeployment.ActivationUri;
        if (activationUri != null && !string.IsNullOrEmpty(activationUri.Query))
        {
            // Parse the query string parameters
            var queryParams = System.Web.HttpUtility.ParseQueryString(activationUri.Query);
            string myMessage = queryParams["message"];
            
            if (!string.IsNullOrEmpty(myMessage))
            {
                label1.Text = myMessage;
            }
        }
    }
    // For local debugging (non-ClickOnce), use command line args
    else
    {
        string[] args = Environment.GetCommandLineArgs();
        if (args.Length > 1)
        {
            label1.Text = args[1];
        }
    }
}

Note: You'll need to add a reference to System.Web in your project for HttpUtility.

For .NET Core/.NET 5+ Apps: #

System.Web isn't available here, so use QueryHelpers from Microsoft.AspNetCore.WebUtilities instead:

1. First, install the Microsoft.AspNetCore.WebUtilities NuGet package.
2. Then use this code:

using Microsoft.AspNetCore.WebUtilities;

private void Form1_Load(object sender, EventArgs e)
{
    if (ApplicationDeployment.IsNetworkDeployed)
    {
        var activationUri = ApplicationDeployment.CurrentDeployment.ActivationUri;
        if (activationUri != null && !string.IsNullOrEmpty(activationUri.Query))
        {
            var queryDict = QueryHelpers.ParseQuery(activationUri.Query);
            string myMessage = queryDict["message"];
            
            if (!string.IsNullOrEmpty(myMessage))
            {
                label1.Text = myMessage;
            }
        }
    }
    // Local debugging fallback
    else
    {
        string[] args = Environment.GetCommandLineArgs();
        if (args.Length > 1)
        {
            label1.Text = args[1];
        }
    }
}

• Skipping the "Allow URL parameters" setting: As mentioned, this is the most common issue—don't forget to enable it before publishing.
• Launching the cached EXE directly: ClickOnce stores the app in a hidden cache folder; double-clicking that EXE won't pass parameters. Always use the .application file or its shortcut.
• Not checking ApplicationDeployment.IsNetworkDeployed: If you skip this check, your code will throw an exception when running locally (since CurrentDeployment only exists for deployed apps).
• Malformed parameters: For URL launches, make sure parameters use valid query string format (e.g., ?key=value&anotherKey=anotherValue). For local launches, just append space-separated key-value pairs.

After making these changes:

1. Republish your app.
2. Launch it using the correct method (URL or shortcut with parameters).
3. Your Label should now display the parameter value!

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