C# run configurations

This topic summarizes the run configurations available for C#. Each table provides keys that are available within a run configuration and their descriptions.

dotnet-launch-settings

.NET Launch Settings
Use it to run and debug .NET Core/ASP.NET Core applications that have their launch settings configured in a 'launchSettings.json' file

`projectPath` (required)	Path to the '.csproj' file of the target project
`profileName` (required)	Name of the profile to launch. A profile with this name must be defined in 'launchSettings.json'.
`environment`	Custom environment variables for the process in the form of a JSON object. To define an environment variable, add a property, where the key is the variable name and the value is the value of the variable, for example: "environment": { "TEMP_DIR": "/home/user/temp", "GENERATE_RANDOM_PASSWORD": "true" }
`dependsOn`	Names of other configurations which will be executed before this configuration, for example: `"dependsOn": ["first", "second"]`. For more information, refer to Chained run configurations.
`workingDir`	Working directory for this run configuration.
`allowParallelRun`	When set to `true`, more than one instance of this configuration can run in parallel.
`solutionPath`	Path to the '.sln' file of the solution if the target project belongs to a solution. Can be left empty if the project doesn't have a solution. Default value: `null`
`targetFramework`	.NET Framework version that will be used to run this configuration Default value: `null`

dotnet

.NET Project
Use it to run and debug .NET projects of executable types, such as console application, Windows Forms application, or WPF application

`projectPath` (required)	Path to the '.csproj' file of the target project
`args` (required)	Arguments that will be passed to the executable when the configuration is started. Multiple arguments should be separated with whitespaces.
`environment`	Custom environment variables for the process in the form of a JSON object. To define an environment variable, add a property, where the key is the variable name and the value is the value of the variable, for example: "environment": { "TEMP_DIR": "/home/user/temp", "GENERATE_RANDOM_PASSWORD": "true" }
`dependsOn`	Names of other configurations which will be executed before this configuration, for example: `"dependsOn": ["first", "second"]`. For more information, refer to Chained run configurations.
`workingDir`	Working directory for this run configuration.
`allowParallelRun`	When set to `true`, more than one instance of this configuration can run in parallel.
`solutionPath`	Path to the '.sln' file of the solution if the target project belongs to a solution. Can be left empty if the project doesn't have a solution. Default value: `null`
`targetFramework`	.NET Framework version that will be used to run this configuration Default value: `null`

Last modified: 11 February 2024