Registrazione manuale di un assembly

Microsoft .NET Framework SDK fornisce lo Strumento di installazione dei servizi .NET Framework (Regsvcs.exe) per la registrazione manuale di un assembly contenente componenti serviti. Regsvcs.exe è uno strumento da riga di comando. È anche possibile accedere alle funzionalità di registrazione direttamente da codice con la classe System.EnterpriseServices.RegistrationHelper creando un'istanza della classe RegistrationHelper e utilizzando il metodo InstallAssembly.

Anche se non è sempre necessario, può essere utile effettuare la registrazione manuale degli assembly per il test in fase di progettazione. A differenza della registrazione automatica, il processo manuale fornisce informazioni sugli errori che si sono verificati durante l'esecuzione.

**Nota   **Se si crea un'applicazione server, sarà necessario aggiungere alla cache dell'assembly globale (GAC, Global Assembly Cache) l'assembly e tutti gli assembly da cui esso dipende tramite Windows Installer prima di poter utilizzare l'applicazione server. In caso contrario, verrà generata un'eccezione.

Nella tabella seguente è riportato l'elenco delle operazioni eseguite da Regsvcs.exe, o dall'API, e degli errori che possono verificarsi in ciascuna fase.

Fase Errore possibile Risultato
Caricamento dell'assembly Impossibile caricare l'assembly. Viene visualizzato un messaggio di errore con la relativa descrizione.
Registrazione dell'assembly Impossibile eseguire la registrazione dei tipi. Gli assembly specificati in modo non corretto generano un'eccezione TypeLoadException.
Creazione di una libreria dei tipi Impossibile creare la libreria. Gli assembly specificati in modo non corretto generano un'eccezione TypeLoadException.
Chiamata del metodo LoadTypeLibrary per la registrazione della libreria dei tipi Impossibile eseguire la chiamata di automazione. Viene generata un'eccezione TypeLoadException.
Installazione della libreria dei tipi nell'applicazione richiesta Lo Strumento di registrazione degli assembly (Regasm.exe) non è in grado di trovare l'applicazione specificata. Viene visualizzato un messaggio di errore per indicare che è impossibile trovare uno degli oggetti.

Per risolvere questo problema, confermare le posizioni della libreria dei tipi e dell'applicazione specificate.

Configurazione della classe Viene rilevato un conflitto tra gli attributi del servizio durante la registrazione. Questo errore si verifica, ad esempio, nel caso di una classe configurata con le seguenti proprietà in conflitto:

TransactionOption.Required

SynchonizationOption.Disabled

Viene visualizzato un messaggio di errore con la descrizione del conflitto oppure viene modificato uno dei servizi non corrispondenti.

Vedere anche

Registrazione dei componenti serviti | Registrazione dinamica di un assembly | Strumento di installazione dei servizi .NET Framework (Regsvcs.exe) | System.EnterpriseServicesRegistrationHelper | Spazio dei nomi System.EnterpriseServices