Target 的 Task 元素 (MSBuild)

  • 發行項

建立及執行 MSBuild 工作的實例。 元素名稱取決於所建立之工作的名稱。

<專案><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] 屬性 (Attribute) 標記的屬性 (Property)，則為必要項目。

使用者定義的工作參數，其中包含參數值當作它的值。 Task 元素中可以有任意數量的參數，而每個屬性 (Attribute) 會對應到工作類別的 .NET 屬性 (Property)。

子元素

元素 描述
輸出 在專案檔中儲存工作的輸出。 工作中可能有零或多個 Output 元素。

父元素

元素 描述
Target MSBuild 工作的 Container 元素。

備註

MSBuild 專案檔中的 Task 元素會建立工作的執行個體，設定屬性，然後執行它。 Output 元素會在專案檔中其他地方會使用的屬性或項目中儲存輸出參數。

如果工作的父 Target 元素中有任何 OnError 元素，則當工作失敗且 ContinueOnError 的值為 false 時，仍然會評估那些元素。 如需工作的詳細資訊，請參閱工作。

範例

下列程式碼範例會建立 Csc 工作類別的執行個體，設定其中六個屬性，然後執行工作。 執行之後，物件的 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>

另請參閱