Tlbexp.exe (Exportador de Biblioteca de Tipos)

O Exportador da Biblioteca de Tipos gera uma biblioteca de tipos que descreve os tipos definidos em um assembly do Common Language Runtime.

Essa ferramenta é instalada automaticamente com o Visual Studio. Para executar a ferramenta, use o Prompt de Comando do Desenvolvedor do Visual Studio ou o PowerShell do Desenvolvedor do Visual Studio.

No prompt de comando, digite o seguinte:

Sintaxe

tlbexp assemblyName [options]  

Parâmetros

Comentários

Tlbexp.exe gera uma biblioteca de tipos que contém definições dos tipos definidos no assembly. Aplicativos como o Visual Basic 6.0 podem usar a biblioteca de tipos gerada na associação com os tipos do .NET definidos no assembly.

Todo o assembly é convertido de uma só vez. Não é possível usar Tlbexp.exe para gerar informações de tipo para um subconjunto dos tipos definidos em um assembly.

Não é possível usar Tlbexp.exe para produzir uma biblioteca de tipos com base em um assembly importado usando o Importador da Biblioteca de Tipos (Tlbimp.exe). Em vez disso, você deve consultar a biblioteca de tipos original importada com Tlbimp.exe. É possível exportar uma biblioteca de tipos de um assembly que faz referência a assemblies que foram importados usando-se Tlbimp.exe. Consulte a seção de exemplos abaixo.

Tlbexp.exe coloca bibliotecas de tipos geradas no diretório de trabalho atual ou no diretório especificado para o arquivo de saída. Um único assembly pode fazer várias bibliotecas de tipos serem geradas.

Tlbexp.exe gera uma biblioteca de tipos, mas não a registra. Isso difere da Ferramenta de Registro do Assembly (Regasm.exe), que gera e registra uma biblioteca de tipos. Para gerar e registrar uma biblioteca de tipos com COM, use Regasm.exe.

Se você não especificar /win32 ou a opção /win64, Tlbexp.exe gerará uma biblioteca de tipos 32 ou 64 bits que corresponde ao tipo do computador no qual você está executando a compilação (computador 32 bits ou 64 bits). Para fins de compilação cruzada, é possível usar a opção /win64 em um computador 32 bits para gerar uma biblioteca de tipos 64 bits e usar a opção /win32 em um computador 64 bits para gerar uma biblioteca de tipos 32 bits. Em bibliotecas de tipos 32 bits, o valor SYSKIND é definido como SYS_WIN32. Em bibliotecas de tipos 64 bits, o valor SYSKIND é definido como SYS_WIN64. Todas as transformações de tipo de dados (por exemplo, tipos de dados do tamanho de ponteiro como, por exemplo, IntPtr e UIntPtr) são convertidas adequadamente.

Se você usar o atributo MarshalAsAttribute para especificar um valor SafeArraySubType de VT_UNKNOWN ou VT_DISPATCH, Tlbexp.exe ignorará qualquer uso subsequente do campo SafeArrayUserDefinedSubType. Por exemplo, dadas as seguintes assinaturas:

[return:MarshalAs(UnmanagedType.SafeArray, SafeArraySubType=VarEnum.VT_UNKNOWN, SafeArrayUserDefinedSubType=typeof(ConsoleKeyInfo))] public Array StructUnkSafe(){return null;}  
[return:MarshalAs(UnmanagedType.SafeArray, SafeArraySubType=VarEnum.VT_DISPATCH, SafeArrayUserDefinedSubType=typeof(ConsoleKeyInfo))] public Array StructDispSafe(){return null;}  

a seguinte biblioteca de tipos é gerada:

[id(0x60020004)]  
HRESULT StructUnkSafe([out, retval] SAFEARRAY(IUnknown*)* pRetVal);  
[id(0x60020005)]  
HRESULT StructDispSafe([out, retval] SAFEARRAY(IDispatch*)* pRetVal);  

Tlbexp.exe ignora o campo SafeArrayUserDefinedSubType.

Como as bibliotecas de tipos não podem acomodar todas as informações encontradas em assemblies, Tlbexp.exe pode descartar alguns dados durante o processo de exportação. Para ver uma explicação do processo de transformação e a identificação da origem de cada informação emitida para uma biblioteca de tipos, consulte Resumo da Conversão do Assembly em Biblioteca de Tipos.

O Exportador da Biblioteca de Tipos exporta métodos com parâmetros TypedReference como VARIANT, mesmo que o objeto TypedReference não tenha significado no código não gerenciado. Quando você exportar métodos com parâmetros TypedReference, o Exportador da Biblioteca de Tipos não gerará um aviso ou um erro, e o código não gerenciado que usa a biblioteca de tipos resultante não será executado corretamente.

Exemplos

O comando a seguir gera uma biblioteca de tipos com o mesmo nome do assembly encontrado em myTest.dll.

tlbexp myTest.dll  

O comando a seguir gera uma biblioteca de tipos com o nome clipper.tlb.

tlbexp myTest.dll /out:clipper.tlb  

O exemplo a seguir ilustra o uso de Tlbexp.exe para exportar uma biblioteca de tipos de um assembly que faz referência a assemblies que foram importados usando-se Tlbimp.exe.

Primeiro use Tlbimp.exe para importar a biblioteca de tipos myLib.tlb e salve-a como myLib.dll.

tlbimp myLib.tlb /out:myLib.dll  

O comando a seguir usa o compilador C# para compilar o Sample.dll, que faz referência myLib.dll ao exemplo anterior.

CSC Sample.cs /reference:myLib.dll /out:Sample.dll  

O comando a seguir gera uma biblioteca de tipos para Sample.dll que faz referência a myLib.dll.

tlbexp Sample.dll  

Confira também

• TypeLibExporterFlags
• Ferramentas
• Regasm.exe (Ferramenta de Registro de Assembly)
• Resumo da conversão de assemblies em bibliotecas de tipos
• Tlbimp.exe (Importador de Biblioteca de Tipos)
• Shells de linha de comando do desenvolvedor