IBuildEngine.BuildProjectFile Method

Initiates a build of a project file. If the build is successful, the outputs, if any, of the specified targets are returned.

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.Framework
Assembly:  Microsoft.Build.Framework (in Microsoft.Build.Framework.dll)

Syntax

'Declaration
Function BuildProjectFile ( _
    projectFileName As String, _
    targetNames As String(), _
    globalProperties As IDictionary, _
    targetOutputs As IDictionary _
) As Boolean
bool BuildProjectFile(
    string projectFileName,
    string[] targetNames,
    IDictionary globalProperties,
    IDictionary targetOutputs
)
bool BuildProjectFile(
    String^ projectFileName, 
    array<String^>^ targetNames, 
    IDictionary^ globalProperties, 
    IDictionary^ targetOutputs
)
abstract BuildProjectFile : 
        projectFileName:string * 
        targetNames:string[] * 
        globalProperties:IDictionary * 
        targetOutputs:IDictionary -> bool
function BuildProjectFile(
    projectFileName : String, 
    targetNames : String[], 
    globalProperties : IDictionary, 
    targetOutputs : IDictionary
) : boolean

Parameters

  • projectFileName
    Type: System.String

    The name of the project file to build.

  • targetNames
    Type: array<System.String[]

    The names of the target in the project to build. Separate multiple targets with a semicolon (;).

Return Value

Type: System.Boolean
true if the build was successful; otherwise, false.

Remarks

The targetNames, globalProperties, and targetOutputs parameters can be nulla null reference (Nothing in Visual Basic).

If no targets are specified, MSBuild builds the default targets of the project.

Target outputs are returned as ITaskItem arrays indexed by target name.

.NET Framework Security

See Also

Reference

IBuildEngine Interface

Microsoft.Build.Framework Namespace