Compartir a través de


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).

  • 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

See Also

Reference

IBuildEngine2 Interface

Microsoft.Build.Framework Namespace