Condividi tramite


Utilità di importazione della libreria dei tipi (Tlbimp.exe)

Aggiornamento: novembre 2007

L'utilità di importazione della libreria dei tipi consente di convertire le definizioni dei tipi presenti in una libreria dei tipi COM nelle definizioni equivalenti di un assembly di Common Language Runtime. L'output di Tlbimp.exe è un file binario (assembly) che contiene metadati per il runtime corrispondenti ai tipi definiti all'interno della libreria dei tipi originale. È possibile esaminare questo file con strumenti quali Ildasm.exe.

tlbimp tlbFile [options]

Parametri

Argomento

Descrizione

Filetlb

Nome di un file che contiene una libreria dei tipi COM.

Opzione

Descrizione

/asmversion:Numeroversione

Consente di specificare il numero di versione dell'assembly da produrre. Specificare Numeroversione nel formato principale.secondaria.build.revisione.

/delaysign

Consente di indicare a Tlbimp.exe di firmare l'assembly risultante con un nome sicuro utilizzando la firma posticipata. È necessario specificare questa opzione con l'opzione /keycontainer:, /keyfile: o /publickey:. Per ulteriori informazioni sulla firma posticipata, vedere Firma posticipata di un assembly.

/help

Visualizza la sintassi e le opzioni dei comandi dello strumento.

/keycontainer:nomecontenitore

Consente di firmare l'assembly risultante con un nome sicuro utilizzando la coppia di chiavi pubblica/privata presente nel contenitore di chiavi specificato da nomecontenitore.

/keyfile:nomefile

Consente di firmare l'assembly risultante con un nome sicuro utilizzando la coppia di chiavi pubblica/privata ufficiale dell'editore trovata in nomefile.

/namespace:spazio dei nomi

Consente di specificare lo spazio dei nomi in cui si desidera produrre l'assembly.

/noclassmembers

Impedisce a Tlbimp.exe di aggiungere membri alle classi. In questo modo è possibile evitare un potenziale TypeLoadException.

/nologo

Evita la visualizzazione del messaggio di avvio Microsoft.

/out:nomefile

Consente di specificare il nome del file di output, l'assembly e lo spazio dei nomi in cui si desidera scrivere le definizioni dei metadati. L'opzione /out non ha alcun effetto sullo spazio dei nomi dell'assembly se la libreria dei tipi specifica l'attributo personalizzato del linguaggio di definizione dell'interfaccia (IDL, Interface Definition Language) che controlla in modo esplicito lo spazio dei nomi dell'assembly. Se non si specifica questa opzione, Tlbimp.exe scrive i metadati in un file avente lo stesso nome della libreria dei tipi definita all'interno del file di input e gli assegna l'estensione DLL. Se il file di output ha lo stesso nome del file di input, lo strumento genera un errore al fine di non sovrascrivere la libreria dei tipi.

/primary

Consente di produrre un assembly di interoperabilità primario per la libreria dei tipi specificata. All'assembly vengono aggiunte informazioni che indicano che l'assembly è prodotto dall'editore della libreria dei tipi. Specificando un assembly di interoperabilità primario, è possibile differenziare l'assembly di un editore da qualsiasi altro assembly creato dalla libreria dei tipi utilizzando Tlbimp.exe. L'opzione /primary può essere utilizzata solo dall'editore della libreria dei tipi importata con Tlbimp.exe. Tenere presente che è necessario firmare l'assembly di interoperabilità primario con un nome sicuro. Per ulteriori informazioni, vedere Assembly di interoperabilità primari.

/publickey:nomefile

Consente di specificare il file che contiene la chiave pubblica da utilizzare per firmare l'assembly risultante. Se si specifica l'opzione /keyfile: o /keycontainer: anziché /publickey:, Tlbimp.exe genera la chiave pubblica dalla coppia di chiavi pubblica/privata fornita con /keyfile: o /keycontainer:. L'opzione /publickey: supporta scenari di firma posticipata e chiavi di prova. Il file è nel formato generato da Sn.exe. Per ulteriori informazioni, vedere l'opzione -p di Sn.exe in Strumento Nome sicuro (Sn.exe).

/reference:nomefile

Consente di specificare il file di assembly da utilizzare per risolvere i riferimenti a tipi definiti all'esterno della libreria dei tipi corrente. Se non si specifica l'opzione /reference, Tlbimp.exe importa automaticamente in modo ricorsivo qualsiasi libreria dei tipi esterna a cui faccia riferimento la libreria dei tipi che viene importata. Se si specifica l'opzione /reference, lo strumento tenta di risolvere i tipi esterni negli assembly a cui si fa riferimento prima di importare altre librerie dei tipi.

/silent

Evita la visualizzazione dei messaggi di operazione riuscita.

/strictref

Consente di non importare la libreria dei tipi se non è possibile risolvere tutti i riferimenti all'interno dell'assembly corrente, degli assembly specificati con l'opzione /reference o degli assembly di interoperabilità primari registrati.

/strictref:nopia

Analogo a /strictref, ma ignora gli assembly di interoperabilità primari registrati.

/sysarray

Consente di indicare allo strumento di importare un SafeArray di stile COM come tipo della classe System.Array gestita.

/tlbreference:nomefile

Consente di specificare il file della libreria dei tipi da utilizzare per risolvere i riferimenti alla libreria dei tipi senza consultare il Registro di sistema.

Utilizzando questa opzione non verranno caricati alcuni formati precedenti di librerie dei tipi. È comunque possibile caricare i formati precedenti di librerie dei tipi in modo implicito mediante il Registro di sistema o la directory corrente.

/transform:Nometrasformazione

Consente di trasformare i metadati, come specificato dal parametro Nometrasformazione.

Specificare dispret per il parametro Nometrasformazione per trasformare i parametri [out, retval] dei metodi su interfacce dispatch (dispinterfaces) in valori restituiti.

Per ulteriori informazioni su questa opzione, vedere gli esempi più avanti in questo argomento.

/unsafe

Consente di produrre interfacce senza controlli di protezione di .NET Framework. Chiamare un metodo esposto in questo modo può comportare rischi di protezione. Non utilizzare questa opzione a meno che non si conoscano i rischi derivanti dell'esposizione di codice di questo tipo.

/verbose

Consente di specificare la modalità dettagliata e visualizzare informazioni aggiuntive sulla libreria dei tipi importata.

/?

Visualizza la sintassi e le opzioni dei comandi dello strumento.

Nota

Le opzioni della riga di comando di Tlbimp.exe non sono soggette alla distinzione tra maiuscole e minuscole e per specificarle non è necessario seguire un ordine particolare. Per identificarle in modo univoco, è sufficiente digitare solo una parte dell'opzione. Pertanto, /n equivale a /nologo e /ou:filedioutput.dll equivale a /out:filedioutput.dll.

Note

Tlbimp.exe converte in blocco l'intera libreria dei tipi. Non è possibile utilizzare Tlbexp.exe per generare informazioni sui tipi per un sottoinsieme dei tipi definiti in una singola libreria dei tipi.

Spesso risulta utile o necessario poter assegnare agli assembly nomi sicuri. Pertanto, Tlbimp.exe include opzioni che permettono di fornire le informazioni necessarie alla generazione di assembly con nomi sicuri. Entrambe le opzioni /keyfile: e /keycontainer: consentono di firmare gli assembly con nomi sicuri. Pertanto, occorre specificare solo una di queste opzioni alla volta.

Quando si importa una libreria dei tipi da un modulo contenente più librerie dei tipi, è possibile aggiungere un ID di risorsa a un file di libreria dei tipi. Tlbimp.exe riesce a individuare questo file solo se si trova nella directory corrente o se si specifica il relativo percorso completo. Vedere l'esempio riportato più avanti in questo argomento.

Esempi

Il comando riportato di seguito consente di generare un assembly con lo stesso nome della libreria dei tipi presente in myTest.tlb e con estensione DLL.

tlbimp myTest.tlb 

Il comando riportato di seguito consente di generare un assembly di nome myTest.dll.

tlbimp  myTest.tlb  /out:myTest.dll

Il comando riportato di seguito consente di generare un assembly con lo stesso nome della libreria dei tipi specificato da MyModule.dll\1 e con estensione DLL. MyModule.dll\1 deve trovarsi nella directory corrente.

tlbimp MyModule.dll\1

Il comando riportato di seguito consente di generare un assembly di nome myTestLib.dll per la libreria dei tipi TestLib.dll. L'opzione /transform:dispret trasforma tutti i parametri [out, retval] dei metodi sulle interfacce dispatch nella libreria dei tipi in valori restituiti nella libreria gestita.

tlbimp TestLib.dll /transform:dispret /out:myTestLib.dll

La libreria dei tipi TestLib.dll, nell'esempio precedente, include un metodo dell'interfaccia dispatch denominato SomeMethod che restituisce un valore void e presenta un parametro [out, retval]. Il codice riportato di seguito è la firma del metodo della libreria dei tipi di input per SomeMethod in TestLib.dll.

void SomeMethod([out, retval] VARIANT_BOOL*);

Se si specifica l'opzione /transform:dispret, Tlbimp.exe trasformerà il parametro [out, retval] di SomeMethod in un valore restituito bool. Di seguito è riportata la firma del metodo prodotta da Tlbimp.exe per SomeMethod nella libreria gestita myTestLib.dll quando viene specificata l'opzione /transform:dispret.

bool SomeMethod();

Se si utilizza Tlbimp.exe per produrre una libreria gestita per TestLib.dll senza specificare /transform:dispret, verrà prodotta la firma del metodo riportata di seguito per SomeMethod nella libreria gestita myTestLib.dll.

void SomeMethod(out bool x);

Vedere anche

Concetti

Importazione di una libreria dei tipi come assembly

Assembly con nomi sicuri

Attributi per l'importazione di librerie dei tipi in assembly di interoperabilità

Riferimenti

Strumenti di .NET Framework

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

Disassembler MSIL (Ildasm.exe)

Strumento Nome sicuro (Sn.exe)

Prompt dei comandi di SDK

Altre risorse

Riepilogo della conversione da libreria dei tipi ad assembly