Target 的 Task 元素 (MSBuild)

  • 项目

创建并执行的 MSBuild 任务的实例。 元素名称由正在创建的任务名称确定。

<Project><Target>

语法

<Task Parameter1="Value1"... ParameterN="ValueN"
    ContinueOnError="WarnAndContinue/true/ErrorAndContinue/ErrorAndStop/false"
    Condition="'String A' == 'String B'" >
    <Output... />
</Task>

特性和元素

下列各节描述了特性、子元素和父元素。

特性

属性 描述
Condition 可选特性。 要计算的条件。 有关详细信息，请参阅条件。
ContinueOnError 可选特性。 可以包含下列值之一：

- WarnAndContinue 或 true。 当任务失败时，Target 元素中的后续任务和生成将继续执行，并且来自该任务的所有错误都被视为警告。
- ErrorAndContinue。 当任务失败时，Target 元素中的后续任务和生成将继续执行，并且来自该任务的所有错误都被视为错误。
- ErrorAndStop 或 false（默认值）。 当任务失败时，将不会执行 Target 元素中的剩余任务和生成，并且整个 Target 元素和生成都被视为已失败。

4.5 之前的 .NET Framework 版本仅支持 true 和 false 值。

有关详细信息，请参阅如何：忽略任务中的错误。
Parameter 如果任务类包含一个或多个标记有 [Required] 特性的属性时，它为必需。

用户定义的任务参数，其中包含作为其值的参数值。 Task 元素中可以有任意数量的参数，其中每个特性均映射到任务类中的 .NET 属性。

子元素

元素 说明
输出 将任务的输出存储于项目文件中。 任务中可能有零个或零个以上 Output 元素。

父元素

元素 说明
Target MSBuild 任务的容器元素。

注解

MSBuild 项目文件中的 Task 元素创建任务实例、在其中设置属性并执行它。 Output 元素存储属性或项中用于项目文件中其他位置的输出参数。

如果任务的父 Target 元素中存在任何 OnError 元素，当任务失败且 ContinueOnError 具有值 false 时仍将对该元素评估。 有关任务的详细信息，请参阅任务。

示例

下面的代码示例创建 Csc 任务类的实例、设置其中 6 个属性并执行任务。 执行任何后，对象的 OutputAssembly 属性的值将放入名为 FinalAssemblyName 的项列表中。

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

另请参阅