UsingTask 項目 (MSBuild)

將 Task 項目中參考的工作，對應至含有工作實作的組件。

<UsingTask TaskName="TaskName"
    AssemblyName = "AssemblyName" 
    TaskFactory = "ClassName"
    Condition="'String A'=='String B'" />

屬性和項目

下列章節會說明屬性、子項目和父項目。

屬性

屬性	描述
AssemblyName	必須有 AssemblyName 屬性或 AssemblyFile 屬性。 要載入的組件名稱。 AssemblyName 屬性接受強式名稱 (Strong Name) 的組件 (雖然強式名稱不是必要的)。 使用這項屬性就等於使用 .NET Framework 中的 Load 方法載入組件。 如果已經使用 AssemblyFile 屬性，就不能使用這項屬性。
AssemblyFile	AssemblyName 或 AssemblyFile 屬性的其中一項是必要的。 組件的檔案路徑。 這項屬性接受完整路徑或相對路徑。 相對路徑是相對於宣告 UsingTask 項目所在專案檔或目標檔的目錄。 使用這項屬性就等於使用 .NET Framework 中的 LoadFrom 方法載入組件。 如果已經使用 AssemblyName 屬性，就不能使用這項屬性。
TaskFactory	選擇性屬性。 在負責產生指定 Task 名稱之執行個體的組件中指定類別。使用者還可以指定 TaskBody 做為工作 Factory 所接收並用於產生工作的子項目。 TaskBody 的內容是專屬於工作 Factory。
TaskName	必要屬性。 從組件參考的工作名稱。 如果有可能形成模糊狀態，這項屬性就應該一直指定完整命名空間。 如果形成模糊狀態，MSBuild 便會選擇任意符合項目，如此可能產生未預期的結果。
Condition	選擇性屬性。 要評估的條件。 如需詳細資訊，請參閱 MSBuild 條件。

子項目

項目	描述
ParameterGroup	一組參數，這會在指定之 TaskFactory 所產生的工作上出現。
TaskBody	傳遞給用來產生工作執行個體之 TaskFactory 的資料。

父項目

項目	描述
專案	MSBuild 專案檔的必要根項目。

備註

如果 UsingTask 項目出現在專案檔中 (不論是明確出現或是透過匯入的專案檔出現)，就能在該項目內的任何位置參考環境參數、命令列屬性和專案層級屬性。 如需詳細資訊，請參閱 MSBuild 工作。

注意事項
如果 UsingTask 項目來自於以 MSBuild 引擎全域註冊的 .tasks 檔案之一，專案層級屬性就不具意義。專案層級屬性對 MSBuild 而言不是全域的。

在 MSBuild 4.0 中，可以從 .overridetask 檔載入使用工作。

範例

下列範例示範如何對 AssemblyName 屬性使用 UsingTask 項目。

<UsingTask TaskName="MyTask" AssemblyName="My.Assembly" TaskFactory="MyTaskFactory">
       <ParameterGroup>
              <Parameter1 ParameterType="System.String" Required="False" Output="False"/>
              <Parameter2 ParameterType="System.Int" Required="True" Output="False"/>
              ...
</ParameterGroup>
       <TaskBody>
      ... Task factory-specific data ...
       </TaskBody>
</UsingTask>

下列範例示範如何對 AssemblyFile 屬性使用 UsingTask 項目。

<UsingTask TaskName="Email"
              AssemblyFile="c:\myTasks\myTask.dll" />

請參閱

概念

MSBuild 工作

MSBuild 專案檔案結構描述參考

其他資源

MSBuild 工作參考