Partilhar via


Tarefa RegisterAssembly

Lê os metadados no assembly especificado e adiciona as entradas necessárias no registro, que permite que clientes COM criar .NET Framework classes de forma transparente. O comportamento desta tarefa é semelhante, mas não idêntico do Ferramenta de registro do conjunto (RegAsm.exe).

Parâmetros

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

Parâmetro

Descrição

Assemblies

Necessário ITaskItem[] parâmetro.

Especifica os assemblies a ser registrado com COM.

AssemblyListFile

Opcional ITaskItem parâmetro.

Contém informações sobre o estado entre o RegisterAssembly tarefa e o UnregisterAssembly tarefa. Isso impede que o UnregisterAssembly tarefa de tentativa de cancelar o registro de um assembly que falhou ao se registrar na RegisterAssembly tarefa.

CreateCodeBase

Opcional Boolean parâmetro.

If true, cria uma entrada de base de código no registro, que especifica o caminho do arquivo para um assembly que não está instalado no cache global de assemblies. Você não deve especificar essa opção se você, em seguida, irá instalar o assembly que você está registrando no cache global de assemblies.

TypeLibFiles

Opcional ITaskItem[] parâmetro de saída.

Especifica a biblioteca de tipos para gerar do conjunto de módulos (assembly) especificado. A biblioteca de tipos gerado contém definições de tipos de acessíveis definidos dentro do assembly. A biblioteca de tipos é gerada apenas se uma das seguintes condições for verdadeira:

  • Uma biblioteca de tipos esse nome não existe nesse local.

  • Existe uma biblioteca de tipos, mas é mais antigo que o assembly que está sendo transmitido.

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

Se este parâmetro for especificado, ele deve ter o mesmo número de itens sistema autônomo o Assemblies parâmetro ou o tsistema autônomok falhará. Se não há entradas forem especificadas, a tarefa será o nome do assembly e altere a extensão do item para .tlb.

Exemplo

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

<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