Partilhar via


Tipo biblioteca Exporter (Tlbexp.exe)

Type Library Exporter gera uma biblioteca de tipos que descreve os tipos definidos em um assembly de tempo de execução linguagem comum.

tlbexp assemblyName [/out:file] [/nologo] [/silent] [/verbose]

Parâmetros

Argumento

Descrição

assemblyName

O assembly para o qual deseja exportar uma biblioteca de tipos.

Opção

Descrição

/asmpath:diretório de

Especifica o local para Pesquisar para assemblies. Se você usar essa opção, você deve especificar explicitamente os locais para procurar por assemblies referenciados, incluindo o diretório corrente.

Quando você usa o asmpath opção, o Type biblioteca Exporter não procurará por um assembly no cache global de assemblies (GAC).

/help

Exibe sintaxe de comando e opções para a ferramenta.

/nomes:nome do arquivo de

Especifica o uso de maiúsculas e minúsculas de nomes em uma biblioteca de tipos. The nome de arquivo argumento é um arquivo de texto. Cada linha no arquivo Especifica o uso de maiúsculas e minúsculas de um nome na biblioteca de tipos.

/nologo

Suprime a exibição Microsoft faixa de inicialização.

/oldnames

Força a TlbExp.exe para exportar os nomes de tipos decorados se houver um conflito de nome de tipo. Observe que esse era o comportamento padrão em versões anteriores à versão 2.0 do .NET estrutura.

/out:arquivo

Especifica o nome do arquivo de biblioteca de tipo para gerar. Se você omitir esta opção, Tlbexp.exe gera uma biblioteca de tipos com o mesmo nome de assembly (o conjunto real nome, que pode não necessariamente ser o mesmo que o arquivo contendo o assembly) e uma extensão de .tlb.

/ silencioso

Suprime a exibição das mensagens de êxito.

/tlbreference:typelibraryname

Força a TlbExp.exe para resolver referências de bibliotecas de tipo explicitamente sem consultar o registro. Por exemplo, se o assembly B referencia o assembly A, você pode usar esta opção para fornecer uma referência de biblioteca de tipo explícito, em vez de contar com a biblioteca de tipos especificada no registro. Tlbexp.exe executa uma verificação de versão para garantir que a versão da biblioteca de tipo corresponde a versão de assembly; caso contrário, ele gerará um erro.

Observe que o tlbreference opção ainda consulta o registro em casos onde o ComImportAttribute atributo é aplicado a uma interface implementada por outro tipo.

/tlbrefpath:caminho

Caminho totalmente qualificado para uma biblioteca de tipos referenciada.

/Win32

Durante a compilação em um computador de 64 bit, essa opção especifica Tlbexp.exe gera uma biblioteca de tipos de 32 bit.

/Win64

When compiling on a 32-bit computer, this option specifies that Tlbexp.exe generates a 64-bit type library.

/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.

/?

Exibe sintaxe de comando e opções para a ferramenta.

ObservaçãoObservação:

As opções de linha de comando do Tlbexp.exe fazem distinção entre maiúsculas e minúsculas e podem ser fornecidas em qualquer ordem. Yo u só precisa especificar suficiente a opção para identificá-lo exclusivamente. Por exemplo, /n is equivalent to /nologo, and /o:outfile.tlb is equivalent to /out:outfile.tlb.

Comentários

Tlbexp.exe gera uma biblioteca de tipos que contém definições de tipos definidas no assembly. Aplicativos sistema autônomo o Visual Basic 6.0 podem usar a biblioteca de tipos gerados para BIND a tipos de .NET definidos no conjunto de módulos (assembly).

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

Não é possível usar Tlbexp.exe para produzir uma biblioteca de tipos de um assembly que foi importado usando o Tipo Library Importer (Tlbimp.exe). Em vez disso, você deve consultar a biblioteca de tipos do original que foi importada com Tlbimp.exe. Você pode exportar uma biblioteca de tipos de um assembly que faz referência a assemblies que foram importados usando Tlbimp.exe. Consulte a seção exemplos abaixo.

Casas Tlbexp.exe gerada bibliotecas de tipos a diretório de trabalho corrente ou o diretório especificado para o arquivo de saída. Um único assembly, isso pode causar várias bibliotecas de tipo a ser gerado.

Tlbexp.exe gera uma biblioteca de tipos, mas não é registrado. Isso é contrário para o Ferramenta de inscrição do assembly (regasm.exe), que gera e registra uma biblioteca de tipos. Para gerar e registrar uma biblioteca de tipos COM, use regasm.exe.

Se você não especificar ambos o /win32 ou /win64 opção, Tlbexp.exe gera uma biblioteca de tipos de 32 bit ou 64 bit que corresponde ao tipo de computador no qual você está executando a compilação (computador de 32 bit ou 64 bit). Para fins de cross-compilação, você pode usar o /win64 opção em um computador de 32 bit para gerar uma biblioteca de tipos de 64 bit e você pode usar o /win32 opção em um computador de 64 bit para gerar uma biblioteca de tipos de 32 bit. Em bibliotecas de tipos de 32 bit, a SYSKIND valor é definido como SYS_WIN32. Em bibliotecas de tipos de 64 bit, a SYSKIND valor é definido como SYS_WIN64. Tipo de dados de todas sistema autônomo transformações (por exemplo, tamanho de ponteiro tipos de dados, sistema autônomo IntPtr e UIntPtr) são convertidos corretamente.

Se você usar o MarshalAsAttribute atributo para especificar um SafeArraySubType valor de VT_UNKOWN ou VT_DISPATCHTlbexp.exe ignora qualquer utilização subseqüente das SafeArrayUserDefinedSubType campo. Por exemplo, conceder 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 biblioteca de tipos a seguir é gerada:

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

Observe a TlbExp.exe ignora o SafeArrayUserDefinedSubType campo.

Porque 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 exportar. Para obter uma explicação sobre o processo de transformação e a identificação da fonte do cada informação emitida para uma biblioteca de tipos, consulte o Conjunto de módulos (assembly) Type Library conversão resumo.

Observe que o Type biblioteca Exporter exporta sistema autônomo métodos que possuem TypedReference parâmetros sistema autônomo VARIANT, mesmo que o TypedReference objeto não tem significado em código não gerenciado. Ao exportar os métodos que possuem TypedReference parâmetros, o Type Library Exporter não irá gerar um aviso ou erro e código não gerenciado que usa a biblioteca de tipos resultante não serão executado corretamente.

Type biblioteca Exporter é suportado no Microsoft Windows 2000 e posteriores.

Exemplos

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

tlbexp myTest.dll

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

tlbexp myTest.dll /out:clipper.tlb

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

Primeiro, use tlbimp.exe para importar o tipo de biblioteca myLib.tlb e salvá-lo sistema autônomo myLib.dll.

tlbimp myLib.tlb /out:myLib.dll

O comando a seguir usa o compilador translation from VPE for Csharp para compilar o Sample.dll, quais referências myLib.dll criado no exemplo anterior.

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

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

tlbexp Sample.dll

Consulte também

Referência

TypeLibExporterFlags

Ferramentas.NET Framework

Ferramenta de registro do conjunto (RegAsm.exe)

Tipo biblioteca Importer (Tlbimp.exe)

Prompt de comando SDK 

Outros recursos

Assembly para o tipo de biblioteca de conversão de resumo