Tarefa RegisterAssembly

  • Artigo

Lê os metadados no assembly especificado e adiciona as entradas necessárias ao Registro, que permite que clientes COM criem classes .NET Framework de maneira transparente. O comportamento dessa tarefa é semelhante, mas não idêntico ao do Regasm.exe (Ferramenta de Registro de Assembly).

Parâmetros

A tabela a seguir descreve os parâmetros da tarefa RegisterAssembly.

Parâmetro Descrição
Assemblies Parâmetro ITaskItem[] obrigatório.

Especifica os assemblies a serem registrados com COM.
AssemblyListFile Parâmetro ITaskItem opcional.

Contém informações sobre o estado entre a tarefa RegisterAssembly e a tarefa UnregisterAssembly. Essas informações impedem que a tarefa UnregisterAssembly tente cancelar o registro de um assembly que falhou ao se registrar na tarefa RegisterAssembly.
CreateCodeBase Parâmetro Boolean opcional.

Se true, cria uma entrada Codebase no Registro, que especifica o caminho de arquivo de um assembly não instalado no cache de assembly global. Você não deverá especificar essa opção se você instalar subsequentemente o assembly que está registrando no cache de assembly global.
TypeLibFiles Parâmetro de saída ITaskItem[] opcional.

Especifica a biblioteca de tipos a ser gerada do assembly especificado. A biblioteca de tipos gerada contém definições dos tipos acessíveis definidos no assembly. A biblioteca de tipos será gerada apenas se uma das seguintes condições for verdadeira:

– Uma biblioteca de tipos com esse nome não existe nesse local.
– Uma biblioteca de tipos existe, mas é mais antiga que o assembly que está sendo passado.

Se a biblioteca de tipos for mais recente do que o assembly sendo passado, uma nova biblioteca não será criada, mas ainda assim o assembly será registrado.

Se esse parâmetro for especificado, ele deverá ter o mesmo número de itens que o parâmetro Assemblies ou a tarefa falhará. Se nenhuma entrada for especificada, a tarefa assumirá por padrão o nome do assembly e alterará a extensão do item para .tlb.

Comentários

Além dos parâmetros listados acima, essa tarefa herda parâmetros da classe TaskExtension, que herda da classe Task. Para obter uma lista desses parâmetros adicionais e suas descrições, confira Classe base TaskExtension.

Exemplo

O exemplo a seguir usa a tarefa RegisterAssembly para registrar o assembly especificado pela coleção de itens MyAssemblies.

<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">

    <ItemGroup>
        <MyAssemblies Include="MyAssembly.dll" />
    <ItemGroup>

    <Target Name="RegisterAssemblies">
        <RegisterAssembly
            Assemblies="@(MyAssemblies)" >
    </Target>

</Project>

Confira também