Tlbexp.exe (utilità di esportazione della libreria dei tipi)

L'utilità di esportazione della libreria dei tipi genera una libreria di tipi che descrive i tipi definiti in un assembly di Common Language Runtime.

Viene installato automaticamente con Visual Studio. Per eseguire lo strumento, usare il prompt dei comandi per gli sviluppatori di Visual Studio o Visual Studio Developer PowerShell.

Al prompt dei comandi digitare quanto segue:

Sintassi

tlbexp assemblyName [options]  

Parametri

Osservazioni:

Tlbexp.exe consente di generare una libreria dei tipi che contiene le definizioni dei tipi definiti nell'assembly. Le applicazioni come Visual Basic 6.0 possono utilizzare la libreria dei tipi generata per operare un'associazione ai tipi .NET definiti nell'assembly.

L'intero assembly viene convertito in un'unica operazione. Non è possibile utilizzare Tlbexp.exe per generare informazioni sui tipi per un sottoinsieme dei tipi definiti in un assembly.

Questo strumento non può essere usato per produrre una libreria dei tipi da un assembly importato mediante l'utilità di importazione della libreria dei tipi (Tlbimp.exe). Al contrario, è necessario riferirsi alla libreria dei tipi originale importata con Tlbimp.exe. È possibile esportare una libreria dei tipi da un assembly che fa riferimento agli assembly importati utilizzando Tlbimp.exe. Vedere la sezione degli esempi di seguito.

Tlbexp.exe colloca le librerie dei tipi generate nella directory di lavoro corrente o nella directory specificata per il file di output. Da un unico assembly possono essere generate più librerie dei tipi.

Tlbexp.exe genera una libreria dei tipi ma non la registra. Questo comportamento è opposto a quello dello strumento di registrazione degli assembly (Regasm.exe), che effettua sia la generazione che la registrazione delle librerie dei tipi. Per generare e registrare una libreria dei tipi con COM, utilizzare Regasm.exe.

Se non si specificano né l'opzione /win32, né l'opzione /win64, verrà generata una libreria dei tipi a 32 o 64 bit corrispondente al tipo di computer, a 32 o a 64 bit, utilizzato per l'esecuzione della compilazione. Ai fini della compilazione incrociata, è possibile utilizzare l'opzione /win64 su un computer a 32 bit per generare una libreria dei tipi a 64 bit e l'opzione /win32 su un computer a 64 bit per generare una libreria dei tipi a 32 bit. Nelle librerie dei tipi a 32 bit il valore di SYSKIND viene impostato su SYS_WIN32. Nelle librerie dei tipi a 64 bit il valore di SYSKIND viene impostato su SYS_WIN64. Tutti i tipi di dati (ad esempio i dati di tipo puntatore quali IntPtr e UIntPtr) vengono convertiti di conseguenza.

Se si utilizza l'attributo MarshalAsAttribute per specificare un valore SafeArraySubType di VT_UNKNOWN o VT_DISPATCH, gli eventuali utilizzi successivi del campo SafeArrayUserDefinedSubType verranno ignorati. Date, ad esempio, le seguenti firme:

[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;}  

verrà generata la seguente libreria dei tipi:

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

Si noti che il campo SafeArrayUserDefinedSubType viene ignorato.

Poiché le librerie dei tipi non possono contenere tutte le informazioni presenti negli assembly, può accadere che in Tlbexp.exe vengano ignorati alcuni dati durante il processo di esportazione. Per informazioni sul processo di trasformazione e sull'identificazione dell'origine di tutti i dati emessi in una libreria dei tipi, vedere Riepilogo della conversione da assembly a libreria dei tipi.

L'utilità di esportazione della libreria dei tipi esporta i metodi con parametri TypedReference di tipo VARIANT, anche se l'oggetto TypedReference non ha significato nel codice non gestito. Quando si esportano metodi con parametri TypedReference, l'utilità in questione non genera un avviso o un errore e il codice non gestito che utilizza la libreria dei tipi risultante non viene eseguito correttamente.

Esempi

Il comando che segue genera una libreria dei tipi con lo stesso nome dell'assembly contenuto in myTest.dll.

tlbexp myTest.dll  

Il comando che segue genera una libreria dei tipi con il nome clipper.tlb.

tlbexp myTest.dll /out:clipper.tlb  

Nell'esempio che segue è illustrato come utilizzare Tlbexp.exe per esportare una libreria dei tipi da un assembly che fa riferimento ad assembly importati mediante Tlbimp.exe.

Utilizzare innanzitutto Tlbimp.exe per importare la libreria dei tipi myLib.tlb e salvarla con il nome myLib.dll.

tlbimp myLib.tlb /out:myLib.dll  

Il comando che segue utilizza il compilatore C# per compilare Sample.dll, che fa riferimento al file myLib.dll creato nell'esempio precedente.

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

Il comando che segue genera una libreria dei tipi per Sample.dll che fa riferimento a myLib.dll.

tlbexp Sample.dll  

Vedi anche

• TypeLibExporterFlags
• Strumenti
• Regasm.exe (strumento di registrazione di assembly)
• Riepilogo della conversione da assembly a libreria dei tipi
• Tlbimp.exe (utilità di importazione della libreria dei tipi)
• Shell della riga di comando per sviluppatori