Share via


ProjectCollection.LoadProject Method (String, IDictionary<String, String>, String)

Evaluates a project from the source code read from the given project file. The source code is evaluated with the given global properties and tools version.

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 Function LoadProject ( _
    fileName As String, _
    globalProperties As IDictionary(Of String, String), _
    toolsVersion As String _
) As Project
public Project LoadProject(
    string fileName,
    IDictionary<string, string> globalProperties,
    string toolsVersion
)
public:
Project^ LoadProject(
    String^ fileName, 
    IDictionary<String^, String^>^ globalProperties, 
    String^ toolsVersion
)
member LoadProject : 
        fileName:string * 
        globalProperties:IDictionary<string, string> * 
        toolsVersion:string -> Project
public function LoadProject(
    fileName : String, 
    globalProperties : IDictionary<String, String>, 
    toolsVersion : String
) : Project

Parameters

  • globalProperties
    Type: IDictionary<String, String>

    The global properties to use. 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.

Return Value

Type: Microsoft.Build.Evaluation.Project
If an existing project in the collection has already been evaluated from the given project file, and with the given global properties and tools version, then the existing project is returned. Otherwise, a new project is created, evaluated, added to the project collection, and returned.

Remarks

In the MSBuild versions that were delivered with .Net 4.5 and Visual Studio 12.0, you must call UnloadProject before the ProjectCollection goes out of scope.

.NET Framework Security

See Also

Reference

ProjectCollection Class

LoadProject Overload

Microsoft.Build.Evaluation Namespace