Compartilhar via


Tarefa UnregisterAssembly

Desregistre que assemblies especificados para interoperabilidade COM purposes. Executa o inverso de tarefa de RegisterAssembly.

Parâmetros

A tabela a seguir descreve os parâmetros de tarefa de UnregisterAssembly .

Parâmetro

Descrição

Assemblies

Parâmetro opcional de ITaskItem[] .

Especifica os assemblies para ser desregistrado.

AssemblyListFile

Parâmetro opcional de ITaskItem .

Contém informações sobre o estado entre a tarefa de RegisterAssembly e a tarefa de UnregisterAssembly . Isso impede que a tarefa tente ao unregister um assembly que não tenha sido registrado na tarefa de RegisterAssembly .

Se o parâmetro for especificado, os parâmetros de Assemblies e de TypeLibFiles são ignorados.

TypeLibFiles

Parâmetro de saída opcional de ITaskItem[] .

Desregistre a biblioteca especificada do tipo de assembly especificado.

Dica

Esse parâmetro é necessário somente se o nome do arquivo de biblioteca de tipos é diferente do nome do assembly.

Comentários

Não é necessário que o assembly que existe para esta tarefa é bem-sucedida. Se você tentar ao unregister um assembly que não existe, a tarefa funcionará com com um aviso. Isso ocorre porque é o trabalho de esta tarefa remova o registro do Registro. Se o assembly não existir, não estiver no Registro e, portanto, a tarefa bem-sucedida.

Além dos parâmetros listados acima, esta tarefa parâmetros herda da classe de AppDomainIsolatedTaskExtension própria, que herda da classe de MarshalByRefObject . A classe de MarshalByRefObject fornece a mesma funcionalidade que a classe de Task , mas pode ser instanciada em seu próprio domínio de aplicativo.

Exemplo

O exemplo a seguir usa a tarefa de UnregisterAssembly ao unregister que o assembly no caminho especificado pelas propriedades de OutputPath e de FileName , se existir.

<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>

Consulte também

Referência

Tarefa RegisterAssembly

Conceitos

Tarefas do MSBuild

Outros recursos

Referência das tarefas do MSBuild