Inscription manuelle d'un assembly
Le Kit de développement .NET Framework SDK fournit l'outil .NET Framework Services Installation Tool (Regsvcs.exe) qui permet d'inscrire manuellement un assembly contenant des composants de service. Regsvcs.exe est un utilitaire de ligne de commande. Ces fonctionnalités d'inscription sont également accessibles par programme, en utilisant la classe System.EnterpriseServices.RegistrationHelper pour créer une instance de la classe RegistrationHelper et en utilisant la méthode InstallAssembly.
Bien que cela ne soit pas requis, il est utile d'inscrire manuellement les assemblys pour les tests effectués au moment du design. Contrairement à l'inscription dynamique, l'inscription manuelle fournit des informations en retour sur les erreurs rencontrées lors de l'exécution de ce processus.
**Remarque **Si vous créez une application serveur, l'assembly et tous les assemblys dont il dépend doivent être ajoutés au cache de l'assembly global (GAC, Global Assembly Cache) à l'aide de Windows Installer avant que celle-ci ne puisse être utilisée. Sinon, l'application génère une exception.
Le tableau ci-dessous répertorie chacune des étapes réalisées par Regsvcs.exe (ou l'API) et décrit les échecs pouvant survenir à chaque étape.
| Étape | Échec possible | Résultat |
|---|---|---|
| Chargement de l'assembly | Le chargement de l'assembly échoue. | Un message d'erreur et une description de l'échec s'affichent. |
| Inscription de l'assembly | L'inscription de type échoue. | Une mauvaise spécification des assemblys entraîne une exception TypeLoadException. |
| Génération d'une bibliothèque de types | La création de la bibliothèque échoue. | Une mauvaise spécification des assemblys entraîne une exception TypeLoadException. |
| Appel de la méthode LoadTypeLibrary pour l'inscription de la bibliothèque de types | L'appel Automation échoue. | Une exception TypeLoadException est générée. |
| Installation de la bibliothèque de types dans l'application demandée | L'outil Assembly Registration Tool (Regasm.exe) ne trouve pas l'application spécifiée. | Un message d'erreur « One of the objects could not be found » s'affiche.
Pour résoudre le problème, confirmez les emplacements de la bibliothèque de types spécifiée et de l'application. |
| Configuration de la classe | L'utilitaire détecte une incompatibilité d'attributs de service durant l'inscription par exemple, si une classe est configurée avec des propriétés conflictuelles telles que :
TransactionOption.Required SynchonizationOption.Disabled |
Une erreur décrivant le conflit s'affiche ou l'un des attributs de service incompatibles est modifié. |
Voir aussi
Inscription de composants de service | Inscription dynamique d'un assembly | Outil .NET Framework Services Installation Tool (Regsvcs.exe) | System.EnterpriseServicesRegistrationHelper | System.EnterpriseServices, espace de noms