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.

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)

Syntax

'Declaration
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

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

bool BuildProjectFilesInParallel(
    array<String^>^ projectFileNames, 
    array<String^>^ targetNames, 
    array<IDictionary^>^ globalProperties, 
    array<IDictionary^>^ targetOutputsPerProject, 
    array<String^>^ toolsVersion, 
    bool useResultsCache, 
    bool unloadProjectsOnCompletion
)

abstract BuildProjectFilesInParallel : 
        projectFileNames:string[] * 
        targetNames:string[] * 
        globalProperties:IDictionary[] * 
        targetOutputsPerProject:IDictionary[] * 
        toolsVersion:string[] * 
        useResultsCache:bool * 
        unloadProjectsOnCompletion:bool -> bool

function BuildProjectFilesInParallel(
    projectFileNames : String[], 
    targetNames : String[], 
    globalProperties : IDictionary[], 
    targetOutputsPerProject : IDictionary[], 
    toolsVersion : String[], 
    useResultsCache : boolean, 
    unloadProjectsOnCompletion : boolean
) : boolean

Parameters

• projectFileNames
  Type: array<System.String[]

  The names of the project files to build.

• targetNames
  Type: array<System.String[]

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

• globalProperties
  Type: array<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 nulla null reference (Nothing in Visual Basic).

• targetOutputsPerProject
  Type: array<System.Collections.IDictionary[]

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

• toolsVersion
  Type: array<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.

Remarks

Both targetNames and targetOutputs accept nulla null reference (Nothing in Visual Basic) 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 Security

• Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see dd66cd4c-b087-415f-9c3e-94e3a1835f74.

See Also

Reference

IBuildEngine2 Interface

Microsoft.Build.Framework Namespace