UsingTask 元素 (MSBuild)

更新：2007 年 11 月

将 Task 元素中引用的任务映射到包含该任务的实现的程序集。

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

属性和元素

以下几节描述了属性、子元素和父元素。

属性	说明
AssemblyName	AssemblyName 或 AssemblyFile 属性是必需的。要加载的程序集的名称。尽管 AssemblyName 属性不是必需的，但它接受强名称程序集。使用此属性等效于通过 .NET Framework 中的 Load 方法加载程序集。如果使用了 AssemblyFile 属性，便不能使用此属性。
AssemblyFile	AssemblyName 或 AssemblyFile 属性是必需的。程序集的文件路径。此属性既接受完整路径，也接受相对路径。相对路径相对于声明 UsingTask 元素的项目或目标文件的目录而言。使用此属性等效于通过 .NET Framework 中的 LoadFrom 方法加载程序集。如果使用了 AssemblyName 属性，便不能使用此属性。
TaskName	必需。要从程序集中引用的任务的名称。如果可能存在多义性，则此属性应该始终指定完整的命名空间。如果存在多义性，MSBuild 将选择任意匹配方式，该匹配方式可能产生意外的结果。
Condition	可选。要计算的条件。有关更多信息，请参见 MSBuild 条件。

无。

元素	说明
Project	MSBuild 项目文件必需的根元素。

只要 UsingTask 元素显式地或者通过导入的项目文件出现在项目文件内，就可以在该元素内的任意位置引用环境变量、命令行属性和项目级属性。有关更多信息，请参见 MSBuild 任务。

说明：
如果 UsingTask 元素来自使用 MSBuild 引擎全局注册的某个 .tasks 文件，则项目级属性没有意义。这些属性对于 MSBuild 而言不是全局的。

下面的示例演示如何将 UsingTask 元素和 AssemblyName 属性结合使用。

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

下面的示例演示如何将 UsingTask 元素和 AssemblyFile 属性结合使用。

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