CallTarget 任务

在项目文件中调用指定的目标。

任务参数

下表描述了 CallTarget 任务的参数。

Parameter

说明

RunEachTargetSeparately

可选 Boolean 输出参数。

如果为 true,则 MSBuild 引擎对每个目标调用一次。 如果为 false,则将调用一次 MSBuild 引擎以生成所有目标。 默认值为 false。

TargetOutputs

可选 ITaskItem[] 输出参数。

包含所有已生成目标的输出。

Targets

可选 String[] 参数。

指定要生成的目标。

UseResultsCache

可选 Boolean 参数。

如果为 true,则返回缓存的结果(如果存在)。

注意   当 MSBuild 任务运行时,其输出以生成项列表的形式缓存在范围(ProjectFileName、GlobalProperties)[TargetNames] 中。

备注

如果 Targets 中指定的某个目标失败且 RunEachTargetSeparately 为 true,则任务会继续生成剩下的目标。

如果要生成默认目标,请使用 MSBuild 任务并将 Projects 参数设为等于 $(MSBuildProjectFile)。

除了上面列出的参数,此任务还将从 TaskExtension 类继承参数,此类本身从 Task 类继承。 有关这些附加参数及其说明的列表,请参见 TaskExtension 基类

示例

下面的示例从 CallOtherTargets 中调用 TargetA。

<Project DefaultTargets="CallOtherTargets"
    xmlns="https://schemas.microsoft.com/developer/msbuild/2003">

    <Target Name="CallOtherTargets">
        <CallTarget Targets="TargetA"/>
    </Target>

    <Target Name="TargetA">
        <Message Text="Building TargetA..." />
    </Target>

</Project>

请参见

概念

MSBuild 目标

其他资源

MSBuild 任务参考