IBuildEngine2.BuildProjectFilesInParallel Method (String[], String[], IDictionary[], IDictionary[], String[], Boolean, Boolean)

 

Allows tasks to initiate parallel builds of the specified project files on systems with multiple processors or multiple core processors. If the builds are successful, the outputs of the specified targets are returned, if any exist.

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)

bool BuildProjectFilesInParallel(
	string[] projectFileNames,
	string[] targetNames,
	IDictionary[] globalProperties,
	IDictionary[] targetOutputsPerProject,
	string[] toolsVersion,
	bool useResultsCache,
	bool unloadProjectsOnCompletion
)

Parameters

projectFileNames
Type: System.String[]

The names of the project files to build.

targetNames
Type: System.String[]

The names of the targets in the project to build. Separate multiple targets with a semicolon (;). Null values are acceptable.

globalProperties
Type: System.Collections.IDictionary[]

An IDictionary of additional global properties to apply to the project. The key and value must be String data types. Array entries can be null.

targetOutputsPerProject
Type: System.Collections.IDictionary[]

The outputs of each specified target. Null values are acceptable.

toolsVersion
Type: System.String[]

Default value = "3.5." Specifies the Toolset version for the build to use. Null values are acceptable.

useResultsCache
Type: System.Boolean

If true, the operation runs only if the cache does not already contain the result. After the operation the result is stored in the cache.

unloadProjectsOnCompletion
Type: System.Boolean

If true the project is unloaded once the operation completes.

Return Value

Type: System.Boolean

True if the build succeeded, false if otherwise.

Both targetNames and targetOutputs accept null values. If no targets are specified, then the default targets are built. Target outputs are returned as ITaskItem arrays indexed by target name.

Return to top
Show: