IBuildEngine2.BuildProjectFilesInParallel Method

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.

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.

.NET Framework

Supported in: 4.5.2, 4.5.1, 4.5, 4, 3.5

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft