IBuildEngine2.BuildProjectFilesInParallel Method

Definition

Namespace:

Microsoft.Build.Framework

Assembly:

Microsoft.Build.Framework.dll

Package:

Microsoft.Build.Framework v17.11.4

Source:

IBuildEngine2.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:
 bool BuildProjectFilesInParallel(cli::array <System::String ^> ^ projectFileNames, cli::array <System::String ^> ^ targetNames, cli::array <System::Collections::IDictionary ^> ^ globalProperties, cli::array <System::Collections::IDictionary ^> ^ targetOutputsPerProject, cli::array <System::String ^> ^ toolsVersion, bool useResultsCache, bool unloadProjectsOnCompletion);

public bool BuildProjectFilesInParallel (string[] projectFileNames, string[] targetNames, System.Collections.IDictionary[] globalProperties, System.Collections.IDictionary[] targetOutputsPerProject, string[] toolsVersion, bool useResultsCache, bool unloadProjectsOnCompletion);

abstract member BuildProjectFilesInParallel : string[] * string[] * System.Collections.IDictionary[] * System.Collections.IDictionary[] * string[] * bool * bool -> bool

Public Function BuildProjectFilesInParallel (projectFileNames As String(), targetNames As String(), globalProperties As IDictionary(), targetOutputsPerProject As IDictionary(), toolsVersion As String(), useResultsCache As Boolean, unloadProjectsOnCompletion As Boolean) As Boolean

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.

targetOutputsPerProject

IDictionary[]

The outputs of each specified target (can be null).

toolsVersion

String[]

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

useResultsCache

Boolean

If true the operation will only be run if the cache doesn't already contain the result. After the operation the result is stored in the cache

unloadProjectsOnCompletion

Boolean

If true the project will be unloaded once the operation is completed

Returns

Boolean

true, if build was successful

Remarks

1) it is acceptable to pass null for both targetNames and targetOutputs 2) if no targets are specified, the default targets are built 3) target outputs are returned as ITaskItem arrays indexed by target name