Project.ToolsVersion Property

Definition

Namespace:

Microsoft.Build.BuildEngine

Assembly:

Microsoft.Build.Engine.dll

Package:

Microsoft.Build.Engine v17.11.4

Source:

Project.cs

When gotten, returns the effective tools version being used by this project. If the tools version is being overridden, the overriding value will be the effective tools version. Otherwise, if there is a ToolsVersion attribute on the Project element, that is the effective tools version. Otherwise, the default tools version of the parent engine is the effective tools version.

When set, overrides the current tools version of this project with the provided value.

NOTE: This is distinct to the ToolsVersion attribute, if any, on the Project element. To get and set the ToolsVersion attribute on the Project element use the Project.DefaultToolsVersion property.

public:
 property System::String ^ ToolsVersion { System::String ^ get(); };

public string ToolsVersion { get; }

member this.ToolsVersion : string

Public ReadOnly Property ToolsVersion As String

Property Value

String

A string representing the version number of the Toolset.

Remarks

If the Toolset version is overridden, that value becomes the effective Toolset version. If there is a ToolsVersion attribute on the Project element, then that is the effective Toolset version. Otherwise, the Toolset version is the same as the default Toolset version of the parent engine. When set, ToolsVersion overrides the current Toolset version of the project with the provided value.

For more information about Toolsets, see Standard and Custom Toolset Configurations.

Note

To get or set the ToolsVersion attribute on the Project element, use the DefaultToolsVersion property.