Ferramenta de registro do conjunto (RegAsm.exe)

Artigo
08/25/2010

A ferramenta de inscrição do assembly lê os metadados dentro de um assembly e adiciona as entradas necessárias no inscrição, que permite que clientes COM criar classes do .NET estrutura com transparência. Após registrar uma classe, qualquer cliente COM pode usá-la sistema autônomo se a classe fosse uma classe COM. A classe é registrada apenas uma vez, quando o assembly está instalado. Não não possível criar instâncias de classes dentro do assembly de COM até que elas realmente são registradas.

regasm assemblyFile [options]

Parâmetros

Parâmetro	Descrição
assemblyFile	O assembly a ser registrado com COM.

Opção	Descrição
/codebase	Cria uma entrada codebase no registro. A entrada Codebase Especifica o caminho do arquivo para um assembly que não está instalado no cache de assembly global. 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. The assemblyFile argumento que você especificar com a /codebase opção deve ser um assembly de nome forte.
/ registrados	Especifica que esta ferramenta só farão referência às bibliotecas de tipos já foi registradas.
/asmpath:diretório	Especifica um diretório que contém referências de assembly. Deve ser usado com o /regfile opção.
/nologo	Suprime a exibição Microsoft faixa de inicialização.
/regfile [:regFile]	Gera o arquivo .reg especificado para o conjunto, que contém as entradas do registro necessárias. Especificar essa opção não altera o registro. Você não pode usar essa opção com o /u or /tlb opções.
/silent or /s	Suprime a exibição das mensagens de êxito.
/tlb [:typeLibFile]	Gera uma biblioteca de tipos do assembly especificado que contém definições dos tipos acessíveis definidos dentro do assembly.
/unregister or /u	As classes creatable encontradas no cancela o registroassemblyFile. Omitir esta opção faz com que o regasm.exe registrar as classes creatable no conjunto de módulos (assembly).
/verbose	Especifica o modo detalhado; exibe uma lista de todos os assemblies referenciados para o qual precisa de uma biblioteca de tipos a ser gerado, quando especificada com o /tlb opção.
/? or /Help	Exibe sintaxe de comando e opções para a ferramenta.

Observação:
As opções de linha de comando regasm.exe não diferenciam maiúsculas de minúsculas. Basta fornecer bastante a opção para identificá-lo exclusivamente. Por exemplo, /n is equivalent to /nologo and /t:outfile.tlb is equivalent to /tlb:outfile.tlb.

Comentários

Você pode usar o /regfile opção para gerar um arquivo .reg que contém as entradas do registro em vez de fazer as alterações diretamente no registro. Você pode atualização o registro em um computador, importando o arquivo .reg com a ferramenta Editor do registro (Regedit.exe). Observe que o arquivo .reg não contém quaisquer atualizações de registro que podem ser feitas pelas funções de registro definidas pelo usuário. Observe que o /regfile opção emite apenas entradas do registro para classes gerenciadas. Essa opção não emitir entradas para TypeLibIDs ou InterfaceIDs.

Quando você especifica o /tlb opção, regasm.exe gera e registra uma biblioteca de tipos descrevendo os tipos no assembly. Regasm.exe coloca as bibliotecas de tipos gerados na diretório de trabalho corrente ou o diretório especificado para o arquivo de saída. Gerando uma biblioteca de tipos para um assembly que faz referência a outros módulos (assemblies) pode causar várias bibliotecas de tipo a ser gerado por vez. Você pode usar a biblioteca de tipos para fornecer informações de tipo para ferramentas de desenvolvimento, como Visual Studio 2005. Você não deve usar o /tlb opção se o assembly que você está registrando foi produzida pela Type biblioteca Importer (Tlbimp.exe). Não é possível exportar uma biblioteca de tipos de um assembly que foi importado de uma biblioteca de tipos. Usando o /tlb opção tem o mesmo efeito que usar o Type Library Exporter (Tlbexp.exe) e regasm.exe, com exceção de que Tlbexp.exe não registra a biblioteca de tipos que ele produz. Se você usar o /tlb opção registrado uma biblioteca de tipos, você pode usar /tlb opção com o /unregister opção de registro cancelado a biblioteca de tipos. Usando as duas opções juntos cancelar o registro do tipo biblioteca e interface entradas, que podem limpar o registro consideravelmente.

Quando você registra um assembly para ser usado por COM, regasm.exe adiciona entradas ao registro no computador local. Mais especificamente, ele cria chaves de registro dependente de versão que permitem que várias versões do mesmo conjunto de módulos (assembly) para executar lado a lado em um computador. A primeira time um assembly estiver registrado, uma chave de nível superior é criada para o assembly e uma subchave exclusiva é criada para a versão específica. Sempre que você registrar uma nova versão do assembly, regasm.exe cria uma subchave para a nova versão.

Por exemplo, considere um cenário onde você registrar o componente gerenciado, myComp.dll, a versão 1.0.0.0 para uso pelo COM. Posteriormente, você pode registrar myComp.dll, versão 2.0.0.0. Você determina que todos os aplicativos de cliente COM o computador estiver usando myComp.dll versão 2.0.0.0 e você decidir cancelar o registro myComponent.dll versão 1.0.0.0. Este esquema de registro permite que você cancelar o registro myComp.dll versão 1.0.0.0 porque somente a versão 1.0.0.0 subchave é removida.

Depois de registrar-se um assembly usando regasm.exe, você pode instalá-lo no cache de assemblies global, de modo que ele pode ser ativado de qualquer cliente COM. Se o assembly for somente para ser ativado por um único aplicativo, você pode colocá-lo no diretório do aplicativo.

Exemplos

O comando a seguir registra todas as classes públicas contidas em myTest.dll.

regasm myTest.dll

O comando a seguir gera o arquivo myTest.reg, que contém todas as entradas de registro necessárias. Este comando não atualiza o registro.

regasm myTest.dll /regfile:myTest.reg

O comando a seguir registra todas as classes públicas contidas em myTest.dlle gera e registra a biblioteca de tipos myTest.tlb, que contém definições de todos os tipos de públicos definidos em myTest.dll.