Run configurations

Last modified: 25 September 2024

ReSharper | Tools | Run Configurations…

(ReSharper_RunConfigSettings)

ReSharper helps you create, manage, and execute multiple run configurations for a solution. A run configuration lets you run or debug a project, a static method or any executable file.

tip

If you have dotUltimate license, you can profile run configurations with JetBrains dotTrace. For more information, refer to How to instantly profile any method in your code with ReSharper and dotTrace.

You can execute run configurations as well as manage them in any way using the Run Configurations popup. To open the popup press or choose ReSharper | Tools | Run Configurations… from the main menu.

ReSharper: Adding a new run cunfiguration

The popup displays all existing run configurations. The active run configuration is highlighted in bold.

Run Configurations in ReSharper Build & Run

You can also execute run configurations in the Build & Run window.

Run configurations in the ReSharper Build & Run window

The active run configuration is shown in the combo box on the window toolbar when you expand the combo box, you will have similar controls as in the Run Configurations popup. Besides, you can use toolbar buttons to run or debug the active configuration, with or without rebuilding.

Active run configuration

Among all run configurations, one is always set as 'active'. The active configuration is executed when you press F5 or choose Debug | Start in the main menu. There is a single run configuration (VS Startup) that exists by default and that you cannot remove. This configuration executes the startup project(s) configured in Visual Studio. Initially, it is set as the active configuration.

As soon as you create a new run configuration, the newly created configuration becomes active automatically.

To set another run configuration as active, select it in the Run Configurations popup, and then choose Configure | Select.

note

ReSharper overrides Visual Studio's Start and Start Without Debugging commands (available in the Debug | Start/Start Without Debugging menu or with F5/Ctrl+F5 shortcuts) to execute ReSharper's active configuration.

If you need to return to the Visual Studio's configuration, choose VS Startup in the Run Configurations popup.

Types of run configurations and their preferences

ReSharper allows you to work with run configurations of three different types. Each configuration is identified by name and has a number of properties specific to its type.

Launch project

With this configuration type, you can run or debug any executable project in your solution. For a large solution with multiple executable projects, this could be an alternative to searching projects in the Solution Explorer and setting the project that you want to execute as the StartUp project.

Static Method

This configuration type lets you run or debug any public static method without parameters. You can use this type of configuration for a static method to run or debug any algorithm or subsystem in your codebase. If necessary, you can use console for interactive execution.

For this type, you need to provide the full name of the method (that is, Project.Class.Method) and optionally, a working directory, architecture, CLR (.NET Framework) version, and a project to build before the execution.

Note that you can execute static methods with a temporary run configuration.

Executable

Using this configuration type, you can run or debug any executable file. If you choose the debug command, ReSharper will run the executable and then make Visual Studio attach to the corresponding process. This configuration type helps you create a complex execution setup (for example, if you are working on a plugin for another program).

For this type, you need to specify the target executable file and optionally, a working directory, command line arguments as well as whether to build a specific project or the whole solution before execution.

Create and edit run configurations

An all-purpose way to create a new run configuration is to use the Run Configurations popup .

warning

Run configurations for static methods are currently not supported for .NET Core projects, see RSRP-459465.

Create a run configuration of any type

  1. Select Add ThemedIcon.AddedParameter.Screen.(Gray).png in the Run Configurations popup and then choose the type of configuration you want to create (Executable, Static Method, or Launch Project).

    If you are creating a run configuration for a project, you can alternatively right-click the project in the Solution Explorer and choose Create Run Configuration.

  2. In the dialog that opens, specify a name and preferences for the configuration, and then click OK

  3. The newly created configuration is saved and becomes active. You can press F5 or click Run on the toolbar to execute it.

For static methods, you can also quickly create a run configuration right in the editor.

Create a run configuration for a static method

  1. Place the caret at the declaration of a public static method without parameters.

  2. Press or click the action indicator on the left.

  3. In the action list that opens, choose Debug ThemedIcon.RunDebug.Screen.(Gray).png and then select any of the items with ellipsis (for example Run...)

  4. In the dialog that opens, ReSharper automatically fills all configuration preferences based on the selected method. If necessary, you can change the name of the configuration and any other preferences.

  5. Click Save & Execute to create the new configuration and execute it in a way that you chose on step 3 (run/debug, with/without building).

    Alternatively, you can click Execute to run/debug the configuration without saving.

If you want to create a copy of an existing run configuration, select it in the Run Configurations popup, and then choose Configure | Duplicate. In the dialog that opens, specify a new name for the copied configuration, change any preferences as required, and click OK to finish.

To modify properties of an existing run configuration, select it in the Run Configurations popup, choose Configure | Edit, and modify the configuration's properties as required.

To remove a run configuration, select it in the Run Configurations popup, and choose Configure | Delete.

For static methods, you can edit, duplicate, and remove the associated run configurations right from the editor. You can recognize a static method that has run configuration by the fixes action indicator ThemedIcon.RunDebug.Screen.(Gray).png to its left. Click this indicator or press and then choose Edit, Duplicate, or Delete actions under the Configure item.

Execute run configurations

Execute active configuration

To run/debug the active configuration, press Ctrl+F5/F5 or choose Debug | Start Without Debugging/Start in the main menu.

note

If you execute a configuration that runs or debugs a specific project, ReSharper will set this project as the StartUp Project automatically.

By default the project/solution is rebuilt. You can also execute the active configuration without rebuilding. To do so, press to run without building or to debug without building.

If you prefer to execute configurations without building, you can change the default behavior. To do so, choose Don't build by default in the Run Configurations popup . When this option is selected, use Ctrl+F5/F5 to execute the active configuration without building and / if you want to rebuild project/solution before execution.

Execute other configurations

You can execute any existing configuration using the Run Configurations popup . To do so, select the desired configuration in the popup, and then choose the proper run/debug command. To execute the Visual Studio's configuration, choose VS Startup in the popup.

Execute run configurations for static methods

ReSharper allows you to execute any public static method without parameters. You can place the caret at such method, press , choose Debug ThemedIcon.RunDebug.Screen.(Gray).png, and then select the desired run/debug command. Before execution starts, you will see a dialog where you will be able to customize execution parameters. Click Execute to execute the method once, or Save & Execute if you want to reuse this configuration.

If a static method has an associated run configuration, ReSharper displays a fixed action indicator ThemedIcon.RunDebug.Screen.(Gray).png to its left. In this case, no dialog is shown when you execute the method.

Attach debugger to a running configuration

If you need to debug a run configuration, you can start it in a debug mode right away. However, if you execute a run configuration with a Run or Run without building commands, you can attach to it anytime later.

note

You can only attach to running configurations of the following types: Static method and Executable.

If you have one or more run configurations running, you can attach to the running process by choosing Attach to [configuration name] in the Run Configurations popup .

ReSharper will automatically switch Visual Studio to the debug mode and attach to the process of the selected run configuration, allowing you to break its execution, step, and so on.

Share run configurations

By default, all run configurations that you create are saved in the 'Solution personal' layer of the ReSharper's layered settings.

If you want to share some run configurations with your team members who work on the same solution, you can move these configurations to the 'Solution team-shared' layer. To do so, select a configuration it in the Run Configurations popup , and choose Configure | Share. To stop sharing a run configuration, choose Configure | Unshare. As soon as you push changes to the shared layer ([SolutionName].sln.DotSettings file) into your VCS and other users pull your change, the shared configuration will be readily available to them.

Note that other team members will be able to modify the shared configuration and the updated version will be available as soon as the 'Solution team-shared' settings layer file is updated through VCS.

See also

Procedures

External Links