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