Inscription de composants de service
Un composant de service est hébergé par une application COM+ et doit être accessible à cette application. À des fins d'accessibilité, les composants de service sont soumis aux contraintes suivantes en termes d'inscription et de configuration :
L'assembly doit avoir un nom fort. Pour plus d'informations, voir la rubrique sur la signature d'un assembly avec un nom fort.
L'assembly doit être inscrit dans le Registre Windows.
Des définitions de bibliothèque de types doivent être inscrites et installées dans l'application COM+ spécifique.
Les services ajoutés à l'aide d'un programme doivent être configurés dans le catalogue COM+.
Informations d'inscription utiles pour les composants de service :
Identité de l'application COM+
Type d'activation
Informations de description
Identité de l'application COM+
Vous pouvez identifier une application cible COM+ existante par son nom ou par son GUID. L'outil .NET Framework Services Installation Tool (Regsvcs.exe) contient l'option /appname : qui permet de spécifier le nom d'une application.
Pour plus d'informations sur la manière de spécifier un nom d'application, voir la rubrique sur la procédure de spécification du nom d'une application avec l'attribut ApplicationName.
Si vous appliquez l'attribut ApplicationID (ou l'attribut Guid) à un assembly, toutes les recherches de l'application sont fondées sur ce GUID, et non sur le nom de l'application.
Pour plus d'informations sur la manière de spécifier un ID d'application, voir la rubrique sur la procédure d'application de l'attribut ApplicationID à un assembly.
Remarque : |
---|
Dans le cas de l'inscription dynamique, la seule manière de spécifier une application cible consiste à appliquer l'attribut ApplicationNameAttribute, ApplicationIDAttribute ou GuidAttribute au moment du design. L'outil .NET Services Installation Tool (Regsvcs.exe) contient le commutateur /appname : qui permet de spécifier le nom de l'application ou son GUID au moment de la compilation. Il comporte en outre le commutateur /parname : destiné à identifier une partition COM+ spécifique. Les partitions COM+ ne sont disponibles que sur les plates-formes Windows Server 2003. |
Si l'application cible n'est pas identifiée ou est introuvable, les mécanismes d'inscription créent une application en utilisant le nom complet de l'assembly sans son numéro de version.
Attention : |
---|
N'utilisez pas l'attribut ApplicationIDAttribute avec les partitions COM+. Si vous utilisez les partitions COM+, l'application de l'attribut ApplicationIDAttribute empêche la configuration des partitions. Les partitions COM+ ne sont disponibles que sur les plates-formes Windows Server 2003. |
Type d'activation
Le type d'activation détermine dans quel processus sont créés les composants de service. Vous pouvez appliquer l'attribut ApplicationActivationAttribute à un assembly pour spécifier le type d'activation. L'attribut ApplicationActivationAttribute doit être déclaré avec l'une des deux valeurs d'énumération suivantes :
ActivationOption.Library : spécifie une application bibliothèque COM+ ; les composants de service de l'assembly sont activés dans le processus de l'appelant.
ActivationOption.Server : spécifie une application serveur COM+ ; les composants de service de l'assembly sont activés dans un nouveau processus fourni par le système.
Remarque : |
---|
Pour plus d'informations sur la définition du type d'activation d'une application, voir la rubrique sur la procédure de définition du type d'activation d'une application. |
Remarque : |
---|
Si la valeur ActivationOption.Server est affectée à l'attribut ApplicationActivationAttribute, l'assembly et tous les assemblys dont il dépend doivent être ajoutés au Global Assembly Cache (GAC) à l'aide de Windows Installer avant que l'application serveur puisse être utilisée, sinon, l'application génère une exception. En outre, si la valeur ApplicationOption.Server est affectée à l'attribut ApplicationActivationAttribute, tous les paramètres des composants de service doivent être marqués en tant que System.Serializable ou dérivés de la classe System.MarshalByRefObject. Sinon, l'application génère une exception. |
Informations de description
La description est facultative, mais elle est parfois utile pour distinguer des assemblys similaires.
Pour plus d'informations sur la définition du type d'activation d'une application, voir la rubrique sur la procédure d'application de l'attribut Description à un assembly.
Les rubriques suivantes de cette section décrivent les mécanismes d'inscription requis pour déployer des applications utilisant des services COM+ :
Ces deux mécanismes d'inscription simplifient le processus d'inscription en combinant les étapes requises pour inscrire un composant de service. Dans les deux cas, l'utilisateur du composant doit être membre du groupe Administrateurs. L'inscription dynamique vous autorise à fournir certaines informations d'inscription au moment du design et d'autres au moment de la compilation. Dans le cas de l'inscription manuelle, vous pouvez spécifier ces informations au moment du design, de la compilation et de l'inscription. Si vous omettez les informations d'inscription, le processus d'inscription les génère à partir de métadonnées. Il détecte et, parfois, corrige les combinaisons d'attributs incompatibles.
Voir aussi
Tâches
Procédure de création d'un composant de service
Référence
ApplicationNameAttribute
ApplicationIDAttribute
GuidAttribute
ApplicationActivationAttribute
DescriptionAttribute
System.EnterpriseServices Namespace
Concepts
Vue d'ensemble des composants de service
Application des attributs pour configurer les services COM+
Exemple de composant de service
Résumé des services COM+ disponibles
Autres ressources
Écriture de composants de service
Extending Metadata Using Attributes
Copyright ©2007 par Microsoft Corporation. Tous droits réservés.