共用方式為


Task 項目 (MSBuild)

更新:2007 年 11 月

建立並執行 MSBuild 工作的執行個體。項目名稱由所要建立的工作名稱決定。

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

屬性和項目

下列小節將說明屬性 (Attribute)、子項目和父項目。

屬性

屬性

描述

Condition

選擇性屬性。要評估的條件。如需詳細資訊,請參閱 MSBuild 條件

ContinueOnError

選擇性屬性。如果沒有指定,便會預設為 false 的布林 (Boolean) 屬性。如果 ContinueOnError 為 false,當工作失敗時,不會執行 Target 項目中其餘的工作,整個 Target 項目也會被視為失敗。

如果此屬性為 true,即使目前的工作失敗,依然會繼續執行 Target 項目中的後續工作,而工作的所有錯誤都會視為警告。

Parameter

如果工作類別 (Class) 含有一或多個以 [Required] 屬性 (Attribute) 標記的屬性 (Property),則此項為必要的。

使用者定義的工作參數,以包含的參數值做為其值。在 Task 項目中可以具有任何數目的參數,而且每個屬性 (Attribute) 都對應於工作類別中的 .NET 屬性 (Property)。

子項目

項目

描述

輸出

在專案檔中儲存工作的輸出。工作中可能有零或多個 Output 項目。

父項目

項目

描述

Target

MSBuild 工作的容器項目。

備註

MSBuild 專案檔中的 Task 項目會建立工作的執行個體 (Instance)、設定屬性,並且加以執行。Output 項目會將要在其他地方使用的屬性或項目之輸出參數,儲存在專案檔中。

如果工作的父 Target 項目中有任何 OnError 項目,當工作失敗且 ContinueOnError 具有 false 值時,這些項目仍然會受到評估。如需工作的詳細資訊,請參閱 MSBuild 工作

範例

在下列程式碼範例中,建立 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>

請參閱

概念

MSBuild 工作

MSBuild 專案檔案結構描述參考

其他資源

MSBuild 工作參考