目标元素 （MSBuild）

包含一组任务，供 MSBuild 按顺序执行。

<项目><目标>

Syntax

<Target Name="Target Name"
        Inputs="Inputs"
        Outputs="Outputs"
        Returns="Returns"
        KeepDuplicateOutputs="true/false"
        BeforeTargets="Targets"
        AfterTargets="Targets"
        DependsOnTargets="DependentTarget"
        Condition="'String A' == 'String B'"
        Label="Label">
    <Task>... </Task>
    <PropertyGroup>... </PropertyGroup>
    <ItemGroup>... </ItemGroup>
    <OnError... />
</Target>

属性和元素

以下部分介绍属性、子元素和父元素。

Attributes

子元素

父元素

注解

在运行时指定要执行的第一个目标。 目标可以依赖于其他目标。 例如，部署目标取决于编译的目标。 MSBuild 引擎按属性中 DependsOnTargets 从左到右的顺序执行依赖项。 有关详细信息，请参阅 “目标”。

MSBuild 依赖于导入顺序，具有特定 Name 属性的目标的最后一个定义是使用的定义。

目标仅在生成过程中执行一次，即使多个目标依赖于该目标也是如此。

如果由于目标属性的计算结果而跳过Condition，则如果稍后在生成中调用目标，并且其Condition属性的true计算结果为当时，仍可以执行该false目标。

在 MSBuild 4 之前， Target 返回属性 Outputs 中指定的任何项。 为此，MSBuild 必须记录这些项目，以防生成中稍后的任务请求这些项。 由于没有办法指示哪些目标具有调用方所需的输出，因此 MSBuild 会累积所有 Outputs 调用 Target的所有项。 这会导致生成存在大量输出项的缩放问题。

如果用户在 Returns 项目中指定任何 Target 元素，则只有 Target具有 Returns 属性记录这些项的元素。

A Target 可以同时包含一个 Outputs 属性和一个 Returns 属性。 Outputs 用于 Inputs 确定目标是否 up-to-date。 Returns如果存在，则重写要确定哪些项返回给调用方的值 Outputs 。 如果 Returns 不存在， Outputs 则将提供给调用方，但前面所述的情况除外。

在 MSBuild 4 之前，每当包含Outputs对同一Target项的多个引用时，都会记录这些重复项。 在具有大量输出和许多项目相互依赖性的大型版本中，这会导致大量内存浪费，因为重复项没有任何用途。 当属性 KeepDuplicateOutputs 设置为 true时，将记录这些重复项。

Example

下面的代码示例演示执行TargetCsc任务的元素。

<Target Name="Compile" DependsOnTargets="Resources" Returns="$(TargetPath)">
    <Csc Sources="@(CSFile)"
          TargetType="library"
          Resources="@(CompiledResources)"
          EmitDebugInformation="$(includeDebugInformation)"
          References="@(Reference)"
          DebugType="$(debuggingType)" >
        <Output TaskParameter="OutputAssembly"
                  ItemName="FinalAssemblyName" />
    </Csc>
</Target>

另请参阅

• 目标
• 项目文件架构参考