Engine.BuildProjectFiles Method

Loads a set of project files from disk and then builds the given list of targets for each project.

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

Syntax

'Declaration
Public Function BuildProjectFiles ( _
    projectFiles As String(), _
    targetNamesPerProject As String()(), _
    globalPropertiesPerProject As BuildPropertyGroup(), _
    targetOutputsPerProject As IDictionary(), _
    buildFlags As BuildSettings, _
    toolsVersions As String() _
) As Boolean

public bool BuildProjectFiles(
    string[] projectFiles,
    string[][] targetNamesPerProject,
    BuildPropertyGroup[] globalPropertiesPerProject,
    IDictionary[] targetOutputsPerProject,
    BuildSettings buildFlags,
    string[] toolsVersions
)

public:
bool BuildProjectFiles(
    array<String^>^ projectFiles, 
    array<array<String^>^>^ targetNamesPerProject, 
    array<BuildPropertyGroup^>^ globalPropertiesPerProject, 
    array<IDictionary^>^ targetOutputsPerProject, 
    BuildSettings buildFlags, 
    array<String^>^ toolsVersions
)

member BuildProjectFiles : 
        projectFiles:string[] * 
        targetNamesPerProject:string[][] * 
        globalPropertiesPerProject:BuildPropertyGroup[] * 
        targetOutputsPerProject:IDictionary[] * 
        buildFlags:BuildSettings * 
        toolsVersions:string[] -> bool

public function BuildProjectFiles(
    projectFiles : String[], 
    targetNamesPerProject : String[][], 
    globalPropertiesPerProject : BuildPropertyGroup[], 
    targetOutputsPerProject : IDictionary[], 
    buildFlags : BuildSettings, 
    toolsVersions : String[]
) : boolean

Parameters

• projectFiles
  Type: array<System.String[]

  A string list of project files to build. This value cannot be nulla null reference (Nothing in Visual Basic).

• targetNamesPerProject
  Type: array<array<System.String[][]

  A BuildPropertyGroup array of targets for each project.

• globalPropertiesPerProject
  Type: array<Microsoft.Build.BuildEngine.BuildPropertyGroup[]

  An IDictionary array of properties for each project. This value cannot be nulla null reference (Nothing in Visual Basic).

• targetOutputsPerProject
  Type: array<System.Collections.IDictionary[]

  A BuildSettings array of tables for target outputs. This value cannot be nulla null reference (Nothing in Visual Basic).

• buildFlags
  Type: Microsoft.Build.BuildEngine.BuildSettings

  A string array of additional build flags.

• toolsVersions
  Type: array<System.String[]

  The ToolsVersion to impose on the project in this build.

Return Value

Type: System.Boolean
true if the project built successfully; otherwise, false.

Remarks

This overload takes a set of global properties for each project to use for the build, returns the target outputs, and also enables the caller to specify additional build flags.

.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

Engine Class

Microsoft.Build.BuildEngine Namespace