UnregisterAssembly 任务
更新:2007 年 11 月
注销用于 COM interop 的指定程序集。执行 RegisterAssembly 任务的反向操作。
参数
下表描述了 UnregisterAssembly 任务的参数。
参数 |
说明 |
||
---|---|---|---|
Assemblies |
可选的 ITaskItem[] 参数。 指定要注销的程序集。 |
||
AssemblyListFile |
可选的 ITaskItem 参数。 包含关于 RegisterAssembly 任务和 UnregisterAssembly 任务之间的状态的信息。这样可以防止该任务尝试注销未能在 RegisterAssembly 任务中注册的程序集。 如果指定此参数,则忽略 Assemblies 和 TypeLibFiles 参数。 |
||
TypeLibFiles |
可选的 ITaskItem[] 输出参数。 从指定程序集中注销指定的类型库。
|
备注
无需程序集存在,此任务也能成功完成。如果尝试注销不存在的程序集,此任务也将成功完成,但会出现一个警告。这是因为此任务的作用是从注册表中移除程序集的注册信息。如果程序集不存在,就不会出现在注册表中,因此,任务成功。
示例
下面的示例使用 UnregisterAssembly 任务注销 OutputPath 和 FileName 属性指定的路径中的程序集(如果存在)。
<Project xmlns="https://schemas.microsoft.com/developer/msbuild/2003">
<PropertyGroup>
<OutputPath>\Output\</OutputPath>
<FileName>MyFile.dll</FileName>
</PropertyGroup>
<Target Name="UnregisterAssemblies">
<UnregisterAssembly
Condition="Exists('$(OutputPath)$(FileName)')"
Assemblies="$(OutputPath)$(FileName)" />
</Target>
</Project>