Compartilhar via


Tarefa RegisterAssembly

Ler metadados do assembly especificado e adiciona as entradas necessárias ao Registro, que permite que os clientes COM criar classes de .NET Framework transparente.O comportamento de esta tarefa é semelhante, mas não idêntico, a de Regasm (ferramenta de registro de Assembly).

Parâmetros

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

Parâmetro

Descrição

Assemblies

Parâmetro necessário ITaskItemde[] .

Especifica os assemblies sejam registrados com COM.

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 de UnregisterAssembly tente ao unregister um assembly que não tenha sido registrado na tarefa de RegisterAssembly .

CreateCodeBase

Parâmetro opcional de Boolean .

Se true, cria uma entrada da no Registro, especificando o caminho de arquivo para um assembly que não está instalado no cache global de assemblies.Você não deve especificar esta opção se você fosse subseqüentemente o assembly que você estar inscrevendo na cache global de assemblies.

TypeLibFiles

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

Especifica a biblioteca de tipos para gerar do assembly especificado.A biblioteca de tipo gerado contém definições de tipos definidos acessíveis dentro do assembly.A biblioteca de tipos é gerada somente se uma das seguintes for verdadeira:

  • Uma biblioteca de tipo de aquele nome não existe em aquele local.

  • Uma biblioteca de tipo existe mas é mais antiga do que o assembly que está sendo passado.

Se a biblioteca de tipos é mais recente que o assembly que está sendo passado, um novo não será criado, mas o assembly será registrado ainda.

Se o parâmetro for especificado, deve ter o mesmo número de itens como o parâmetro de Assemblies ou a tarefa irão falhar.Se nenhuma entrada for especificada, a tarefa usará como padrão o nome do assembly e alterará a extensão de item a .tlb.

Comentários

Além dos parâmetros listados acima, esta tarefa parâmetros herda da classe de TaskExtension própria, que herda da classe de Task .Para obter uma lista de esses parâmetros adicionais e suas descrições, consulte Classe Base TaskExtension.

Exemplo

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

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

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

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

</Project>

Consulte também

Conceitos

Tarefas do MSBuild

Outros recursos

Referência de tarefa do MSBuild