Regasm.exe (strumento di registrazione di assembly)
Lo strumento di registrazione di assembly legge i metadati all'interno di un assembly e aggiunge al Registro di sistema le voci necessarie per consentire ai client COM di creare classi di .NET Framework in modo trasparente. Quando una classe è stata registrata, qualsiasi client COM può utilizzarla come se si trattasse di una classe COM. La classe viene registrata una sola volta, al momento dell'installazione dell'assembly. Non è possibile creare da COM istanze di classi nell'assembly finché tali classi non sono state effettivamente registrate.
Per eseguire lo strumento, usare il prompt dei comandi per gli sviluppatori di Visual Studio o Visual Studio Developer PowerShell.
Sintassi
regasm assemblyFile [options]
Parametri
| Parametro | Descrizione |
|---|---|
| fileAssembly | Assembly da registrare con COM. |
| Opzione | Descrizione |
|---|---|
/codebase |
Crea una voce Codebase nel Registro di sistema La voce Codebase specifica il percorso del file per un assembly non installato nella Global Assembly Cache. Non specificare questa opzione se successivamente si installerà l'assembly che si sta registrando nella Global Assembly Cache. È consigliabile specificare l'argomento assemblyFile con l'opzione /codebase come assembly con nome sicuro. |
/registered |
Specifica che questo strumento includerà riferimenti solo alle librerie dei tipi che sono già state registrate. |
/asmpath:directory |
Specifica una directory contenente riferimenti agli assembly. Deve essere usato con l'opzione /regfile . |
/nologo |
Evita la visualizzazione del messaggio di avvio Microsoft. |
/regfile [: regFile] |
Genera il file .reg specificato per l'assembly, che contiene le voci del Registro di sistema necessarie. Se si specifica questa opzione, il Registro di sistema non viene modificato. Non è possibile usare questa opzione con le /u opzioni o /tlb . |
/silent oppure /s |
Evita la visualizzazione dei messaggi di operazione riuscita. |
/tlb [: typeLibFile] |
Genera, dall'assembly specificato, una libreria dei tipi contenente le definizioni dei tipi accessibili definiti all'interno dell'assembly stesso. |
/unregister oppure /u |
Annulla la registrazione delle classi che possono essere create e trovate in fileAssembly. Se questa opzione viene omessa, le classi nell'assembly verranno registrate. |
/verbose |
Specifica la modalità dettagliata; visualizza un elenco di assembly a cui si fa riferimento per cui deve essere generata una libreria dei tipi, se specificato con l'opzione /tlb . |
/? oppure /help |
Visualizza la sintassi e le opzioni di comando dello strumento. |
Nota
Le opzioni della riga di comando di Regasm.exe non sono soggette alla distinzione tra maiuscole e minuscole. Per identificarle in modo univoco, è sufficiente digitare solo una parte dell'opzione. Ad esempio, /n è equivalente a /nologo e /t: outfile.tlb equivale a /tlb: outfile.tlb.
Osservazioni:
È possibile usare l'opzione /regfile per generare un file .reg che contiene le voci del Registro di sistema anziché apportare le modifiche direttamente al Registro di sistema. Per aggiornare il Registro di sistema su un computer è necessario importare il file .reg con lo strumento Editor del Registro di sistema (Regedit.exe). Il file .reg non contiene aggiornamenti del Registro di sistema che possono essere eseguiti da funzioni di registro definite dall'utente. L'opzione /regfile genera solo voci del Registro di sistema per le classi gestite. Questa opzione non genera TypeLibID voci o InterfaceID .
Quando si specifica l'opzione /tlb , Regasm.exe genera e registra una libreria dei tipi che descrive i tipi trovati nell'assembly. Le librerie dei tipi generate vengono inserite nella directory di lavoro corrente o nella directory specificata per il file di output. Se viene generata una libreria dei tipi per un assembly che fa riferimento ad altri assembly, è possibile che vengano generate più librerie dei tipi contemporaneamente. La libreria dei tipi può essere usata per fornire informazioni sui tipi a strumenti di sviluppo come Visual Studio. Non usare l'opzione /tlb se l'assembly che si sta registrando è stato prodotto dall'utilità di importazione della libreria dei tipi (Tlbimp.exe). Non è possibile esportare una libreria dei tipi da un assembly importato da una libreria dei tipi. L'uso dell'opzione /tlb ha lo stesso effetto dell'uso dell'utilità di esportazione della libreria dei tipi (Tlbexp.exe) e Regasm.exe, con l'eccezione che Tlbexp.exe non registra la libreria dei tipi generata. Se si usa l'opzione /tlb per registrare una libreria dei tipi, è possibile usare l'opzione /tlb con l'opzione /unregister per annullare la registrazione della libreria dei tipi. L'utilizzo congiunto di queste due opzioni determina l'annullamento della registrazione delle voci di interfaccia e di libreria dei tipi, con conseguente pulitura del Registro di sistema.
Quando si registra un assembly per consentirne l'utilizzo da parte di COM, sul computer locale vengono aggiunte delle voci al Registro di sistema. In particolare, vengono create chiavi del Registro di sistema dipendenti dalla versione che consentono l'esecuzione side-by-side di più versioni dello stesso assembly su un computer. La prima volta che viene registrato un assembly, viene creata una chiave di primo livello per l'assembly e viene creata una sottochiave univoca per la versione specifica. Ogni volta che si registra una nuova versione dell'assembly, viene creata una sottochiave per la nuova versione.
Si consideri, ad esempio, uno scenario in cui si registra il componente gestito myComp.dll, versione 1.0.0.0 per consentirne l'utilizzo da parte di COM. Successivamente si registra myComp.dll, versione 2.0.0.0. Viene verificato che tutte le applicazioni client COM presenti nel computer usano myComp.dll versione 2.0.0.0 e si decide di annullare la registrazione di myComponent.dll versione 1.0.0.0. Questo schema del Registro di sistema consente di annullare la registrazione di myComp.dll versione 1.0.0.0 in quanto viene rimossa solo la sottochiave della versione 1.0.0.0.
Dopo aver registrato un assembly tramite Regasm.exe, è possibile installarlo nella Global Assembly Cache in modo che possa essere attivato da qualsiasi client COM. Se l'assembly dovrà essere attivato da un'unica applicazione, è possibile inserirlo nella directory di tale applicazione. L'uso dell'opzione /codebase è un'alternativa all'uso della Global Assembly Cache. Tuttavia, la posizione dell'assembly durante la registrazione viene registrata a livello globale e l'attivazione avrà esito negativo se l'assembly viene spostato. Se l'assembly non viene trovato tramite il probe, l'opzione /codebase caricherà l'assembly in un contesto di caricamento da cui sono documentate considerazioni aggiuntive in Assembly.LoadFrom.
Esempi
Il comando che segue registra tutte le classi pubbliche contenute in myTest.dll.
regasm myTest.dll
Il comando che segue genera il file myTest.reg contenente tutte le voci di Registro di sistema necessarie. Questo comando non aggiorna il Registro di sistema.
regasm myTest.dll /regfile:myTest.reg
Il comando che segue registra tutte le classi pubbliche contenute in myTest.dll e genera e registra la libreria dei tipi myTest.tlb che contiene le definizioni di tutti i tipi pubblici definiti in myTest.dll.
regasm myTest.dll /tlb:myTest.tlb
