Share via


Project Constructor (String, IDictionary<String, String>, String, String, ProjectCollection, ProjectLoadSettings)

Constructs a project and evaluates it from the given source project file and with the given global properties, tools and sub-toolset versions, project collection, and load settings.

MSBuild is now included in Visual Studio instead of the .NET Framework. You can use MSBuild 12.0 side-by-side with versions previously deployed with the .NET Framework.For more information, see What's New in MSBuild 12.0.

Namespace:  Microsoft.Build.Evaluation
Assembly:  Microsoft.Build (in Microsoft.Build.dll)

Syntax

'Declaration
Public Sub New ( _
    projectFile As String, _
    globalProperties As IDictionary(Of String, String), _
    toolsVersion As String, _
    subToolsetVersion As String, _
    projectCollection As ProjectCollection, _
    loadSettings As ProjectLoadSettings _
)
public Project(
    string projectFile,
    IDictionary<string, string> globalProperties,
    string toolsVersion,
    string subToolsetVersion,
    ProjectCollection projectCollection,
    ProjectLoadSettings loadSettings
)
public:
Project(
    String^ projectFile, 
    IDictionary<String^, String^>^ globalProperties, 
    String^ toolsVersion, 
    String^ subToolsetVersion, 
    ProjectCollection^ projectCollection, 
    ProjectLoadSettings loadSettings
)
new : 
        projectFile:string * 
        globalProperties:IDictionary<string, string> * 
        toolsVersion:string * 
        subToolsetVersion:string * 
        projectCollection:ProjectCollection * 
        loadSettings:ProjectLoadSettings -> Project
public function Project(
    projectFile : String, 
    globalProperties : IDictionary<String, String>, 
    toolsVersion : String, 
    subToolsetVersion : String, 
    projectCollection : ProjectCollection, 
    loadSettings : ProjectLoadSettings
)

Parameters

  • projectFile
    Type: System.String

    The path to the source project file to be evaluated.

  • globalProperties
    Type: IDictionary<String, String>

    Global properties to evaluate with. May be null in which case the containing project collection's global properties will be used.

  • toolsVersion
    Type: System.String

    The tools version. May be null.

  • subToolsetVersion
    Type: System.String

    The sub toolset version. May be null.

Remarks

The project is added to the given project collection.

Throws InvalidProjectFileException if the evaluation fails. Throws InvalidOperationException if there is already an equivalent project loaded in the project collection. May throw IO-related exceptions.

.NET Framework Security

See Also

Reference

Project Class

Project Overload

Microsoft.Build.Evaluation Namespace