UnregisterAssembly 任务

注销用于 COM 互操作 的指定程序集。执行 RegisterAssembly 任务的反向操作。

参数

下表描述了 UnregisterAssembly 任务的参数。

Parameter

说明

Assemblies

可选 ITaskItem[] 参数。

指定要注销的程序集。

AssemblyListFile

可选 ITaskItem 参数。

包含关于 RegisterAssembly 任务和 UnregisterAssembly 任务之间的状态的信息。这样可以防止该任务尝试注销未能在 RegisterAssembly 任务中注册的程序集。

如果指定此参数,则忽略 AssembliesTypeLibFiles 参数。

TypeLibFiles

可选 ITaskItem[] 输出参数。

从指定程序集中注销指定的类型库。

说明说明
只有在类型库文件名与程序集名称不同时,此参数才是必需的。

备注

无需程序集存在,此任务也能成功完成。如果尝试注销不存在的程序集,此任务也将成功完成,但会出现一个警告。这是因为此任务的作用是从注册表中移除程序集的注册信息。如果程序集不存在,就不会出现在注册表中,因此,任务成功。

除了上面列出的参数,此任务还将从 AppDomainIsolatedTaskExtension 类继承参数,此类本身从 MarshalByRefObject 类继承。MarshalByRefObject 类提供与 Task 类相同的功能,但可以在其自己的应用程序域中进行实例化。

示例

下面的示例使用 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>

请参见

参考

RegisterAssembly 任务

概念

MSBuild 任务

其他资源

MSBuild 任务参考