Share via


IBuildEngine9 Interface

Definition

This interface extends IBuildEngine8 to provide resource management API to tasks.

public interface class IBuildEngine9 : Microsoft::Build::Framework::IBuildEngine8
public interface IBuildEngine9 : Microsoft.Build.Framework.IBuildEngine8
type IBuildEngine9 = interface
    interface IBuildEngine8
    interface IBuildEngine7
    interface IBuildEngine6
    interface IBuildEngine5
    interface IBuildEngine4
    interface IBuildEngine3
    interface IBuildEngine2
    interface IBuildEngine
Public Interface IBuildEngine9
Implements IBuildEngine8
Derived
Implements

Properties

AllowFailureWithoutError (Inherited from IBuildEngine7)
ColumnNumberOfTaskNode

Retrieves the line number of the task node within the project file that called it.

(Inherited from IBuildEngine)
ContinueOnError

Returns true if the ContinueOnError flag was set to true for this particular task in the project file.

(Inherited from IBuildEngine)
IsRunningMultipleNodes

This property allows a task to query whether or not the system is running in single process mode or multi process mode. Single process mode (IsRunningMultipleNodes = false) is where the engine is initialized with the number of cpus = 1 and the engine is not a child engine. The engine is in multi process mode (IsRunningMultipleNodes = true) when the engine is initialized with a number of cpus > 1 or the engine is a child engine.

(Inherited from IBuildEngine2)
LineNumberOfTaskNode

Retrieves the line number of the task node within the project file that called it.

(Inherited from IBuildEngine)
ProjectFileOfTaskNode

Returns the full path to the project file that contained the call to this task.

(Inherited from IBuildEngine)

Methods

BuildProjectFile(String, String[], IDictionary, IDictionary)

This method allows tasks to initiate a build on a particular project file. If the build is successful, the outputs (if any) of the specified targets are returned.

(Inherited from IBuildEngine)
BuildProjectFile(String, String[], IDictionary, IDictionary, String)

This method allows tasks to initiate a build on a particular project file. If the build is successful, the outputs (if any) of the specified targets are returned.

(Inherited from IBuildEngine2)
BuildProjectFilesInParallel(String[], String[], IDictionary[], IDictionary[], String[], Boolean, Boolean)

This method allows tasks to initiate a build on a particular project file. If the build is successful, the outputs (if any) of the specified targets are returned.

(Inherited from IBuildEngine2)
BuildProjectFilesInParallel(String[], String[], IDictionary[], IList<String>[], String[], Boolean)

This method allows tasks to initiate a build on a particular project file. If the build is successful, the outputs (if any) of the specified targets are returned.

(Inherited from IBuildEngine3)
GetGlobalProperties()

Gets the global properties for the current project.

(Inherited from IBuildEngine6)
GetRegisteredTaskObject(Object, RegisteredTaskObjectLifetime)

Retrieves a previously registered task object stored with the specified key.

(Inherited from IBuildEngine4)
LogCustomEvent(CustomBuildEventArgs)

Allows tasks to raise custom events to all registered loggers. The build engine may perform some filtering or pre-processing on the events, before dispatching them.

(Inherited from IBuildEngine)
LogErrorEvent(BuildErrorEventArgs)

Allows tasks to raise error events to all registered loggers. The build engine may perform some filtering or pre-processing on the events, before dispatching them.

(Inherited from IBuildEngine)
LogMessageEvent(BuildMessageEventArgs)

Allows tasks to raise message events to all registered loggers. The build engine may perform some filtering or pre-processing on the events, before dispatching them.

(Inherited from IBuildEngine)
LogTelemetry(String, IDictionary<String,String>)

Logs telemetry.

(Inherited from IBuildEngine5)
LogWarningEvent(BuildWarningEventArgs)

Allows tasks to raise warning events to all registered loggers. The build engine may perform some filtering or pre-processing on the events, before dispatching them.

(Inherited from IBuildEngine)
Reacquire()

Waits to reacquire control after yielding.

(Inherited from IBuildEngine3)
RegisterTaskObject(Object, Object, RegisteredTaskObjectLifetime, Boolean)

Registers an object with the system that will be disposed of at some specified time in the future.

(Inherited from IBuildEngine4)
ReleaseCores(Int32)

A task should notify the build manager when all or some of the requested cores are not used anymore. When task is finished, the cores it requested are automatically released.

RequestCores(Int32)

If a task launches multiple parallel processes, it should ask how many cores it can use.

ShouldTreatWarningAsError(String)

Determines whether the logging service will convert the specified warning code into an error.

(Inherited from IBuildEngine8)
UnregisterTaskObject(Object, RegisteredTaskObjectLifetime)

Unregisters a previously-registered task object.

(Inherited from IBuildEngine4)
Yield()

Informs the system that this task has a long-running out-of-process component and other work can be done in the build while that work completes.

(Inherited from IBuildEngine3)

Applies to