UsingTask 項目 (MSBuild)

更新：2007 年 11 月

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

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

屬性和項目

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

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

無。

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

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

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

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

<UsingTask TaskName="Microsoft.Build.Tasks.Csc"
              AssemblyName="Microsoft.Build.Tasks" />

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

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