IBuildEngine3.BuildProjectFilesInParallel Method

Definition

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

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

Applies to