RegisterAssembly tarefas

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

Parâmetros

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

Parâmetro	Descrição
Assemblies	Obrigatório ITaskItem[] parâmetro. Especifica os assemblies sejam registrados com COM.
AssemblyListFile	Opcional ITaskItem parâmetro. Contém informações sobre o estado entre a RegisterAssembly tarefa e o UnregisterAssembly tarefa. Isso impede que o UnregisterAssembly tarefa tentar cancelar o registro de um assembly que falhou ao se registrar na RegisterAssembly de tarefas.
CreateCodeBase	Opcional Boolean parâmetro. Se true, cria uma entrada codebase 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ê subseqüentemente instalará o assembly que você estiver registrando no cache global de assemblies.
TypeLibFiles	Opcional ITaskItem[] parâmetro de saída. Especifica a biblioteca de tipos para gerar a partir do assembly especificado. A biblioteca de tipo gerado contém definições dos tipos acessíveis definidos dentro do assembly. A biblioteca de tipos é gerada somente se uma das seguintes opções for verdadeira: Uma biblioteca de tipos desse nome não existe nesse local. Existe uma biblioteca de tipo, mas é mais antigo que o assembly que está sendo passado. 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 como o Assemblies parâmetro ou a tarefa irá falhar. Se nenhuma entrada for especificada, a tarefa será o nome do assembly e altere a extensão do item para. tlb.

Comentários

Framework64 / <version> / RegisterAssemblyTask não é possível resolver uma biblioteca de objetos de COM registrados como componentes de 32 bits. Estrutura / <version> / RegisterAssemblyTask não é possível resolver uma biblioteca de objetos de COM registrados como componentes de 64 bits.

Por exemplo, se você registrar uma biblioteca de objetos COM, denominado ClassLibrary1 como componentes de 32 bits em uma máquina de 64 bits, execute o Visual Studio e alterar o destino para x64, a compilação falhará com o seguinte erro:

ClassLibrary1.dll is not a valid assembly

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

Exemplo

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

<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