IBuildEngine3.BuildProjectFilesInParallel Method

Definition

Namespace:

Microsoft.Build.Framework

Assembly:

Microsoft.Build.Framework.dll

Package:

Microsoft.Build.Framework v17.11.4

Source:

IBuildEngine3.cs

This method allows tasks to initiate a build on a particular project file. If the build is successful, the outputs (if any) of the specified targets are returned.

public:
 Microsoft::Build::Framework::BuildEngineResult BuildProjectFilesInParallel(cli::array <System::String ^> ^ projectFileNames, cli::array <System::String ^> ^ targetNames, cli::array <System::Collections::IDictionary ^> ^ globalProperties, cli::array <System::Collections::Generic::IList<System::String ^> ^> ^ removeGlobalProperties, cli::array <System::String ^> ^ toolsVersion, bool returnTargetOutputs);

public Microsoft.Build.Framework.BuildEngineResult BuildProjectFilesInParallel (string[] projectFileNames, string[] targetNames, System.Collections.IDictionary[] globalProperties, System.Collections.Generic.IList<string>[] removeGlobalProperties, string[] toolsVersion, bool returnTargetOutputs);

abstract member BuildProjectFilesInParallel : string[] * string[] * System.Collections.IDictionary[] * System.Collections.Generic.IList<string>[] * string[] * bool -> Microsoft.Build.Framework.BuildEngineResult

Public Function BuildProjectFilesInParallel (projectFileNames As String(), targetNames As String(), globalProperties As IDictionary(), removeGlobalProperties As IList(Of String)(), toolsVersion As String(), returnTargetOutputs As Boolean) As BuildEngineResult

Parameters

projectFileNames

String[]

The project to build.

targetNames

String[]

The targets in the project to build (can be null).

globalProperties

IDictionary[]

An array of hashtables of additional global properties to apply to the child project (array entries can be null). The key and value in the hashtable should both be strings.

removeGlobalProperties

IList<String>[]

A list of global properties which should be removed.

toolsVersion

String[]

A tools version recognized by the Engine that will be used during this build (can be null).

returnTargetOutputs

Boolean

Should the target outputs be returned in the BuildEngineResult

Returns

BuildEngineResult

Returns a structure containing the success or failure of the build and the target outputs by project.

Remarks

1) it is acceptable to pass null for both targetNames and targetOutputs 2) if no targets are specified, the default targets are built