Project.Build Method

Definition

Builds this project, using the default targets.

Overloads

Build(String[], IEnumerable<ILogger>, IEnumerable<ForwardingLoggerRecord>)

Starts a build using this project, building the specified targets with the specified loggers. Returns true on success, false on failure. If build is disabled on this project, does not build, and returns false. Works on a privately cloned instance. To set or get virtual items for build purposes, clone an instance explicitly and build that. Does not modify the Project object.

Build(String, IEnumerable<ILogger>, IEnumerable<ForwardingLoggerRecord>)

Starts a build using this project, building the specified target with the specified loggers. Returns true on success, false on failure. Works on a privately cloned instance. To set or get virtual items for build purposes, clone an instance explicitly and build that. Does not modify the Project object.

Build(String[], IEnumerable<ILogger>)

Starts a build using this project, building the specified targets with the specified loggers. Returns true on success, false on failure. If build is disabled on this project, does not build, and returns false. Works on a privately cloned instance. To set or get virtual items for build purposes, clone an instance explicitly and build that. Does not modify the Project object.

Build(String, IEnumerable<ILogger>)

Starts a build using this project, building the specified target with the specified loggers. Returns true on success, false on failure. Works on a privately cloned instance. To set or get virtual items for build purposes, clone an instance explicitly and build that. Does not modify the Project object.

Build(IEnumerable<ILogger>, IEnumerable<ForwardingLoggerRecord>)

Starts a build using this project, building the default targets and the specified loggers. Returns true on success, false on failure. Works on a privately cloned instance. To set or get virtual items for build purposes, clone an instance explicitly and build that. Does not modify the Project object.

Build(String[], IEnumerable<ILogger>, IEnumerable<ForwardingLoggerRecord>, EvaluationContext)

See Build(String[], IEnumerable<ILogger>, IEnumerable<ForwardingLoggerRecord>).

Build(String)

Starts a build using this project, building the specified target. Returns true on success, false on failure. Works on a privately cloned instance. To set or get virtual items for build purposes, clone an instance explicitly and build that. Does not modify the Project object.

Build(IEnumerable<ILogger>)

Starts a build using this project, building the default targets and the specified loggers. Returns true on success, false on failure. Works on a privately cloned instance. To set or get virtual items for build purposes, clone an instance explicitly and build that. Does not modify the Project object.

Build(ILogger)

Starts a build using this project, building the default targets and the specified logger. Returns true on success, false on failure. Works on a privately cloned instance. To set or get virtual items for build purposes, clone an instance explicitly and build that. Does not modify the Project object.

Build()

Starts a build using this project, building the default targets. Returns true on success, false on failure. Works on a privately cloned instance. To set or get virtual items for build purposes, clone an instance explicitly and build that. Does not modify the Project object.

Build(String[])

Starts a build using this project, building the specified targets. Returns true on success, false on failure. Works on a privately cloned instance. To set or get virtual items for build purposes, clone an instance explicitly and build that. Does not modify the Project object.

Build(String[], IEnumerable<ILogger>, IEnumerable<ForwardingLoggerRecord>)

Starts a build using this project, building the specified targets with the specified loggers. Returns true on success, false on failure. If build is disabled on this project, does not build, and returns false. Works on a privately cloned instance. To set or get virtual items for build purposes, clone an instance explicitly and build that. Does not modify the Project object.

public:
 bool Build(cli::array <System::String ^> ^ targets, System::Collections::Generic::IEnumerable<Microsoft::Build::Framework::ILogger ^> ^ loggers, System::Collections::Generic::IEnumerable<Microsoft::Build::Logging::ForwardingLoggerRecord ^> ^ remoteLoggers);
public bool Build (string[] targets, System.Collections.Generic.IEnumerable<Microsoft.Build.Framework.ILogger> loggers, System.Collections.Generic.IEnumerable<Microsoft.Build.Logging.ForwardingLoggerRecord> remoteLoggers);
member this.Build : string[] * seq<Microsoft.Build.Framework.ILogger> * seq<Microsoft.Build.Logging.ForwardingLoggerRecord> -> bool
Public Function Build (targets As String(), loggers As IEnumerable(Of ILogger), remoteLoggers As IEnumerable(Of ForwardingLoggerRecord)) As Boolean

Parameters

targets
String[]

Targets to build.

loggers
IEnumerable<ILogger>

List of loggers.

remoteLoggers
IEnumerable<ForwardingLoggerRecord>

Remote loggers for multi proc logging.

Returns

Returns true on success and false on failure or disabled build.

Remarks

To set or get virtual items for build purposes, clone a project instance explicitly and build that. This method does not modify the project object.

Applies to

Build(String, IEnumerable<ILogger>, IEnumerable<ForwardingLoggerRecord>)

Starts a build using this project, building the specified target with the specified loggers. Returns true on success, false on failure. Works on a privately cloned instance. To set or get virtual items for build purposes, clone an instance explicitly and build that. Does not modify the Project object.

public:
 bool Build(System::String ^ target, System::Collections::Generic::IEnumerable<Microsoft::Build::Framework::ILogger ^> ^ loggers, System::Collections::Generic::IEnumerable<Microsoft::Build::Logging::ForwardingLoggerRecord ^> ^ remoteLoggers);
public bool Build (string target, System.Collections.Generic.IEnumerable<Microsoft.Build.Framework.ILogger> loggers, System.Collections.Generic.IEnumerable<Microsoft.Build.Logging.ForwardingLoggerRecord> remoteLoggers);
member this.Build : string * seq<Microsoft.Build.Framework.ILogger> * seq<Microsoft.Build.Logging.ForwardingLoggerRecord> -> bool
Public Function Build (target As String, loggers As IEnumerable(Of ILogger), remoteLoggers As IEnumerable(Of ForwardingLoggerRecord)) As Boolean

Parameters

target
String

Target to build.

loggers
IEnumerable<ILogger>

List of loggers.

remoteLoggers
IEnumerable<ForwardingLoggerRecord>

Remote loggers for multi proc logging.

Returns

Returns true on success and false on failure or disabled build.

Remarks

To set or get virtual items for build purposes, clone a project instance explicitly and build that. This method does not modify the project object.

Applies to

Build(String[], IEnumerable<ILogger>)

Starts a build using this project, building the specified targets with the specified loggers. Returns true on success, false on failure. If build is disabled on this project, does not build, and returns false. Works on a privately cloned instance. To set or get virtual items for build purposes, clone an instance explicitly and build that. Does not modify the Project object.

public:
 bool Build(cli::array <System::String ^> ^ targets, System::Collections::Generic::IEnumerable<Microsoft::Build::Framework::ILogger ^> ^ loggers);
public bool Build (string[] targets, System.Collections.Generic.IEnumerable<Microsoft.Build.Framework.ILogger> loggers);
[System.Runtime.TargetedPatchingOptOut("Performance critical to inline this type of method across NGen image boundaries")]
public bool Build (string[] targets, System.Collections.Generic.IEnumerable<Microsoft.Build.Framework.ILogger> loggers);
member this.Build : string[] * seq<Microsoft.Build.Framework.ILogger> -> bool
[<System.Runtime.TargetedPatchingOptOut("Performance critical to inline this type of method across NGen image boundaries")>]
member this.Build : string[] * seq<Microsoft.Build.Framework.ILogger> -> bool
Public Function Build (targets As String(), loggers As IEnumerable(Of ILogger)) As Boolean

Parameters

targets
String[]

Targets to build.

loggers
IEnumerable<ILogger>

List of loggers.

Returns

Returns true on success and false on failure or disabled build.

Attributes

Remarks

To set or get virtual items for build purposes, clone a project instance explicitly and build that. This method does not modify the project object.

Applies to

Build(String, IEnumerable<ILogger>)

Starts a build using this project, building the specified target with the specified loggers. Returns true on success, false on failure. Works on a privately cloned instance. To set or get virtual items for build purposes, clone an instance explicitly and build that. Does not modify the Project object.

public:
 bool Build(System::String ^ target, System::Collections::Generic::IEnumerable<Microsoft::Build::Framework::ILogger ^> ^ loggers);
public bool Build (string target, System.Collections.Generic.IEnumerable<Microsoft.Build.Framework.ILogger> loggers);
[System.Runtime.TargetedPatchingOptOut("Performance critical to inline this type of method across NGen image boundaries")]
public bool Build (string target, System.Collections.Generic.IEnumerable<Microsoft.Build.Framework.ILogger> loggers);
member this.Build : string * seq<Microsoft.Build.Framework.ILogger> -> bool
[<System.Runtime.TargetedPatchingOptOut("Performance critical to inline this type of method across NGen image boundaries")>]
member this.Build : string * seq<Microsoft.Build.Framework.ILogger> -> bool
Public Function Build (target As String, loggers As IEnumerable(Of ILogger)) As Boolean

Parameters

target
String

Target to build.

loggers
IEnumerable<ILogger>

List of loggers.

Returns

Returns true on success and false on failure or disabled build.

Attributes

Remarks

To set or get virtual items for build purposes, clone a project instance explicitly and build that. This method does not modify the project object.

Applies to

Build(IEnumerable<ILogger>, IEnumerable<ForwardingLoggerRecord>)

Starts a build using this project, building the default targets and the specified loggers. Returns true on success, false on failure. Works on a privately cloned instance. To set or get virtual items for build purposes, clone an instance explicitly and build that. Does not modify the Project object.

public:
 bool Build(System::Collections::Generic::IEnumerable<Microsoft::Build::Framework::ILogger ^> ^ loggers, System::Collections::Generic::IEnumerable<Microsoft::Build::Logging::ForwardingLoggerRecord ^> ^ remoteLoggers);
public bool Build (System.Collections.Generic.IEnumerable<Microsoft.Build.Framework.ILogger> loggers, System.Collections.Generic.IEnumerable<Microsoft.Build.Logging.ForwardingLoggerRecord> remoteLoggers);
[System.Runtime.TargetedPatchingOptOut("Performance critical to inline this type of method across NGen image boundaries")]
public bool Build (System.Collections.Generic.IEnumerable<Microsoft.Build.Framework.ILogger> loggers, System.Collections.Generic.IEnumerable<Microsoft.Build.Logging.ForwardingLoggerRecord> remoteLoggers);
member this.Build : seq<Microsoft.Build.Framework.ILogger> * seq<Microsoft.Build.Logging.ForwardingLoggerRecord> -> bool
[<System.Runtime.TargetedPatchingOptOut("Performance critical to inline this type of method across NGen image boundaries")>]
member this.Build : seq<Microsoft.Build.Framework.ILogger> * seq<Microsoft.Build.Logging.ForwardingLoggerRecord> -> bool
Public Function Build (loggers As IEnumerable(Of ILogger), remoteLoggers As IEnumerable(Of ForwardingLoggerRecord)) As Boolean

Parameters

loggers
IEnumerable<ILogger>

List of loggers.

remoteLoggers
IEnumerable<ForwardingLoggerRecord>

Remote loggers for multi proc logging.

Returns

Returns true on success and false on failure or disabled build.

Attributes

Remarks

To set or get virtual items for build purposes, clone a project instance explicitly and build that. This method does not modify the project object.

Applies to

Build(String[], IEnumerable<ILogger>, IEnumerable<ForwardingLoggerRecord>, EvaluationContext)

public:
 bool Build(cli::array <System::String ^> ^ targets, System::Collections::Generic::IEnumerable<Microsoft::Build::Framework::ILogger ^> ^ loggers, System::Collections::Generic::IEnumerable<Microsoft::Build::Logging::ForwardingLoggerRecord ^> ^ remoteLoggers, Microsoft::Build::Evaluation::Context::EvaluationContext ^ evaluationContext);
public bool Build (string[] targets, System.Collections.Generic.IEnumerable<Microsoft.Build.Framework.ILogger> loggers, System.Collections.Generic.IEnumerable<Microsoft.Build.Logging.ForwardingLoggerRecord> remoteLoggers, Microsoft.Build.Evaluation.Context.EvaluationContext evaluationContext);
member this.Build : string[] * seq<Microsoft.Build.Framework.ILogger> * seq<Microsoft.Build.Logging.ForwardingLoggerRecord> * Microsoft.Build.Evaluation.Context.EvaluationContext -> bool
Public Function Build (targets As String(), loggers As IEnumerable(Of ILogger), remoteLoggers As IEnumerable(Of ForwardingLoggerRecord), evaluationContext As EvaluationContext) As Boolean

Parameters

targets
String[]

Targets to build.

loggers
IEnumerable<ILogger>

List of loggers.

remoteLoggers
IEnumerable<ForwardingLoggerRecord>

Remote loggers for multi proc logging.

evaluationContext
EvaluationContext

The evaluation context to use in case reevaluation is required.

Returns

Returns true on success and false on failure or disabled build.

Applies to

Build(String)

Starts a build using this project, building the specified target. Returns true on success, false on failure. Works on a privately cloned instance. To set or get virtual items for build purposes, clone an instance explicitly and build that. Does not modify the Project object.

public:
 bool Build(System::String ^ target);
public bool Build (string target);
[System.Runtime.TargetedPatchingOptOut("Performance critical to inline this type of method across NGen image boundaries")]
public bool Build (string target);
member this.Build : string -> bool
[<System.Runtime.TargetedPatchingOptOut("Performance critical to inline this type of method across NGen image boundaries")>]
member this.Build : string -> bool
Public Function Build (target As String) As Boolean

Parameters

target
String

Target to build.

Returns

Returns true on success and false on failure or disabled build.

Attributes

Remarks

To set or get virtual items for build purposes, clone a project instance explicitly and build that. This method does not modify the project object.

Applies to

Build(IEnumerable<ILogger>)

Starts a build using this project, building the default targets and the specified loggers. Returns true on success, false on failure. Works on a privately cloned instance. To set or get virtual items for build purposes, clone an instance explicitly and build that. Does not modify the Project object.

public:
 bool Build(System::Collections::Generic::IEnumerable<Microsoft::Build::Framework::ILogger ^> ^ loggers);
public bool Build (System.Collections.Generic.IEnumerable<Microsoft.Build.Framework.ILogger> loggers);
[System.Runtime.TargetedPatchingOptOut("Performance critical to inline this type of method across NGen image boundaries")]
public bool Build (System.Collections.Generic.IEnumerable<Microsoft.Build.Framework.ILogger> loggers);
member this.Build : seq<Microsoft.Build.Framework.ILogger> -> bool
[<System.Runtime.TargetedPatchingOptOut("Performance critical to inline this type of method across NGen image boundaries")>]
member this.Build : seq<Microsoft.Build.Framework.ILogger> -> bool
Public Function Build (loggers As IEnumerable(Of ILogger)) As Boolean

Parameters

loggers
IEnumerable<ILogger>

List of loggers.

Returns

Returns true on success and false on failure or disabled build.

Attributes

Remarks

To set or get virtual items for build purposes, clone a project instance explicitly and build that. This method does not modify the project object.

Applies to

Build(ILogger)

Starts a build using this project, building the default targets and the specified logger. Returns true on success, false on failure. Works on a privately cloned instance. To set or get virtual items for build purposes, clone an instance explicitly and build that. Does not modify the Project object.

public:
 bool Build(Microsoft::Build::Framework::ILogger ^ logger);
public bool Build (Microsoft.Build.Framework.ILogger logger);
member this.Build : Microsoft.Build.Framework.ILogger -> bool
Public Function Build (logger As ILogger) As Boolean

Parameters

logger
ILogger

Logger to use.

Returns

Returns true on success and false on failure or disabled build.

Remarks

To set or get virtual items for build purposes, clone a project instance explicitly and build that. This method does not modify the project object.

Applies to

Build()

Starts a build using this project, building the default targets. Returns true on success, false on failure. Works on a privately cloned instance. To set or get virtual items for build purposes, clone an instance explicitly and build that. Does not modify the Project object.

public:
 bool Build();
public bool Build ();
[System.Runtime.TargetedPatchingOptOut("Performance critical to inline this type of method across NGen image boundaries")]
public bool Build ();
member this.Build : unit -> bool
[<System.Runtime.TargetedPatchingOptOut("Performance critical to inline this type of method across NGen image boundaries")>]
member this.Build : unit -> bool
Public Function Build () As Boolean

Returns

Returns true on success and false on failure or disabled build.

Attributes

Remarks

To set or get virtual items for build purposes, clone a project instance explicitly and build that. This method does not modify the project object.

Applies to

Build(String[])

Starts a build using this project, building the specified targets. Returns true on success, false on failure. Works on a privately cloned instance. To set or get virtual items for build purposes, clone an instance explicitly and build that. Does not modify the Project object.

public:
 bool Build(cli::array <System::String ^> ^ targets);
public bool Build (string[] targets);
[System.Runtime.TargetedPatchingOptOut("Performance critical to inline this type of method across NGen image boundaries")]
public bool Build (string[] targets);
member this.Build : string[] -> bool
[<System.Runtime.TargetedPatchingOptOut("Performance critical to inline this type of method across NGen image boundaries")>]
member this.Build : string[] -> bool
Public Function Build (targets As String()) As Boolean

Parameters

targets
String[]

Targets to build.

Returns

Returns true on success and false on failure or disabled build.

Attributes

Remarks

To set or get virtual items for build purposes, clone a project instance explicitly and build that. This method does not modify the project object.

Applies to