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.

• 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

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

• 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