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

• xml
  Type: Microsoft.Build.Construction.ProjectRootElement

  The project root to use for evaluation.

• 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.

• projectCollection
  Type: Microsoft.Build.Evaluation.ProjectCollection

  The project collection the project is added to. May not be null.

• loadSettings
  Type: Microsoft.Build.Evaluation.ProjectLoadSettings

  The load settings to use for evaluation.

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

• Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see dd66cd4c-b087-415f-9c3e-94e3a1835f74.

See Also

Reference

Project Class

Project Overload

Microsoft.Build.Evaluation Namespace