IBuildEngine4 接口

定义

此接口扩展 IBuildEngine 以提供结构允许任务可以共享在任务调用之间的数据。This interface extends IBuildEngine to provide a mechanism allowing tasks to share data between task invocations.

public interface class IBuildEngine4 : Microsoft::Build::Framework::IBuildEngine3
public interface IBuildEngine4 : Microsoft.Build.Framework.IBuildEngine3
type IBuildEngine4 = interface
    interface IBuildEngine3
    interface IBuildEngine2
    interface IBuildEngine
Public Interface IBuildEngine4
Implements IBuildEngine3
派生
实现

属性

ColumnNumberOfTaskNode

检索任务节点在调用该任务的项目文件内的行号。Retrieves the line number of the task node within the project file that called it.

(继承自 IBuildEngine)
ContinueOnError

如果对项目文件中的此特定任务将 ContinueOnError 标志设置为 true,则返回 true。Returns true if the ContinueOnError flag was set to true for this particular task in the project file.

(继承自 IBuildEngine)
IsRunningMultipleNodes

此属性允许任务查询系统是在单进程模式下运行还是在多进程模式下运行。This property allows a task to query whether or not the system is running in single process mode or multi process mode. 单进程模式 (IsRunningMultipleNodes = false) 是指用 cpu 数 = 1 初始化引擎,而引擎不是子引擎的位置。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. 当使用多个 cpu 1 初始化引擎 > 或引擎为子引擎时,该引擎处于多进程模式 (IsRunningMultipleNodes = true) 。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.

(继承自 IBuildEngine2)
LineNumberOfTaskNode

检索任务节点在调用该任务的项目文件内的行号。Retrieves the line number of the task node within the project file that called it.

(继承自 IBuildEngine)
ProjectFileOfTaskNode

返回包含对此任务的调用的项目文件的完整路径。Returns the full path to the project file that contained the call to this task.

(继承自 IBuildEngine)

方法

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.

(继承自 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.

(继承自 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.

(继承自 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.

(继承自 IBuildEngine3)
GetRegisteredTaskObject(Object, RegisteredTaskObjectLifetime)

检索使用指定键存储的以前注册的任务对象。Retrieves a previously registered task object stored with the specified key.

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.

(继承自 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.

(继承自 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.

(继承自 IBuildEngine)
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.

(继承自 IBuildEngine)
Reacquire()

等待生成后重新获得控制。Waits to reacquire control after yielding.

(继承自 IBuildEngine3)
RegisterTaskObject(Object, Object, RegisteredTaskObjectLifetime, Boolean)

注册在将来一段指定的时间将被释放的系统中的一个对象。Registers an object with the system that will be disposed of at some specified time in the future.

UnregisterTaskObject(Object, RegisteredTaskObjectLifetime)

注销以前注册的任务对象。Unregisters a previously-registered task object.

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.

(继承自 IBuildEngine3)

适用于