Project.Build Method

Definition

Namespace:

Microsoft.Build.Evaluation

Assembly:

Microsoft.Build.dll

Package:

Microsoft.Build v17.11.4

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

Source:

Project.cs

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

Boolean

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.

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

Source:

Project.cs

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

Boolean

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.

Build(String[], IEnumerable<ILogger>)

Source:

Project.cs

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

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

Boolean

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.

Build(String, IEnumerable<ILogger>)

Source:

Project.cs

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

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

Boolean

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.

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

Source:

Project.cs

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

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

Boolean

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.

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

Source:

Project.cs

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

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

Boolean

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

Build(String)

Source:

Project.cs

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

member this.Build : string -> bool

Public Function Build (target As String) As Boolean

Parameters

target

String

Target to build.

Returns

Boolean

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.

Build(IEnumerable<ILogger>)

Source:

Project.cs

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

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

Boolean

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.

Build(ILogger)

Source:

Project.cs

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

Boolean

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.

Build()

Source:

Project.cs

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 ();

member this.Build : unit -> bool

Public Function Build () As Boolean

Returns

Boolean

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.

Build(String[])

Source:

Project.cs

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

member this.Build : string[] -> bool

Public Function Build (targets As String()) As Boolean

Parameters

targets

String[]

Targets to build.

Returns

Boolean

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.