Share via


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

Constructs a project and evaluates it using the given project root 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 ( _
    xml As ProjectRootElement, _
    globalProperties As IDictionary(Of String, String), _
    toolsVersion As String, _
    subToolsetVersion As String, _
    projectCollection As ProjectCollection, _
    loadSettings As ProjectLoadSettings _
)
public Project(
    ProjectRootElement xml,
    IDictionary<string, string> globalProperties,
    string toolsVersion,
    string subToolsetVersion,
    ProjectCollection projectCollection,
    ProjectLoadSettings loadSettings
)
public:
Project(
    ProjectRootElement^ xml, 
    IDictionary<String^, String^>^ globalProperties, 
    String^ toolsVersion, 
    String^ subToolsetVersion, 
    ProjectCollection^ projectCollection, 
    ProjectLoadSettings loadSettings
)
new : 
        xml:ProjectRootElement * 
        globalProperties:IDictionary<string, string> * 
        toolsVersion:string * 
        subToolsetVersion:string * 
        projectCollection:ProjectCollection * 
        loadSettings:ProjectLoadSettings -> Project
public function Project(
    xml : ProjectRootElement, 
    globalProperties : IDictionary<String, String>, 
    toolsVersion : String, 
    subToolsetVersion : String, 
    projectCollection : ProjectCollection, 
    loadSettings : ProjectLoadSettings
)

Parameters

  • 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

    Tools version to evaluate with. May be null.

  • subToolsetVersion
    Type: System.String

    Sub toolset version to evaluate with. May be null.

Remarks

This project is added to the given project collection when either this project or the given project root is given the full path to the source project file.

Throws InvalidProjectFileException if the evaluation fails. Throws InvalidOperationException if there is already an equivalent project loaded in the project collection.

.NET Framework Security

See Also

Reference

Project Class

Project Overload

Microsoft.Build.Evaluation Namespace