Procédure : utiliser l’outil de configuration de modèle de service COM+
Une fois que vous avez sélectionné un mode d'hébergement approprié, utilisez l'outil en ligne de commande de configuration de modèle de service COM+ (ComSvcConfig.exe) pour configurer les interfaces d'application qui seront exposées en tant que services Web.
Notes
Vous devez être administrateur sur l’ordinateur pour exécuter chacune des tâches suivantes.
Lorsque vous utilisez ComSvcConfig.exe sur un ordinateur Windows 7 pour configurer un service Web de façon à utiliser la dernière version de modèle de service (v4.5), exécutez les étapes suivantes :
Affectez à la clé de Registre
[HKEY_LOCAL_COMPUTER\SOFTWARE\Microsoft\.NETFramework]\OnlyUseLatestCLRla valeur DWORD 0x00000001Exécutez comsvcconfig.exe.
Rétablissez la valeur par défaut de la clé de Registre ajoutée à l'étape 1, ou supprimez -la si elle n'existait pas.
Important
Il est important de rétablir cette clé de Registre. Il s'agit d'une clé de compatibilité. Le fait de ne pas rétablir cette modification peut provoquer des problèmes avec d'autres applications .NET en cours de exécution sur l'ordinateur.
Avertissement
Lorsque vous utilisez ComSvcConfig.exe /install sur un ordinateur Windows 8, une boîte de dialogue s’affiche indiquant « Une application sur votre ordinateur nécessite la fonctionnalité Windows suivante : .NET Framework 3.5 (inclut .NET 2.0 et .NET 3.0 si .NET Framework 3.5 n’est pas installé). Cette boîte de dialogue peut être ignorée. Vous pouvez aussi affecter à la clé de Registre OnlyUseLatestCLR la valeur DWORD 0x00000001.
Ajouter une interface à l’aide du mode d’hébergement COM+
Exécutez ComSvcConfig avec les options
/installet/hosting:complus, comme illustré dans l'exemple suivant.ComSvcConfig.exe /install /application:OnlineStore /contract:ItemOrders.Financial,IFinances /hosting:complus /verboseLa commande ajoute l'interface
IFinancesdu composantItemOrders.IFinancial(depuis l'application COM+ OnlineStore) à l'ensemble des interfaces qui seront exposées en tant que services Web. Le service utilise le mode d'hébergement COM+, et requiert par conséquent l'activation d'application explicite.Bien que le caractère générique * puisse être utilisé pour le composant et l'interface, évitez de l'utiliser car vous souhaiterez peut-être exposer uniquement certaines fonctionnalités sélectionnées en tant que service Web. En cas d'exécution avec une version ultérieure de ce composant, l'utilisation du caractère générique peut exposer involontairement des interfaces qui étaient peut-être absentes lorsque la syntaxe de configuration a été déterminée.
L'option /verbose fait en sorte que l'outil affiche des avertissements en plus des éventuelles erreurs.
Le contrat pour le service exposé contiendra toutes les méthodes de l'interface
IFinances.
Ajouter des méthodes spécifiques à partir d’une interface à l’aide du mode d’hébergement COM+
Exécutez ComSvcConfig avec les options
/installet/hosting:compluset avec la désignation explicite des méthodes requises, comme illustré dans l'exemple suivant.ComSvcConfig.exe /install /application:OnlineStore /contract:ItemOrders.Financial,IFinances.{Credit,Debit} /hosting:complus /verboseLa commande ajoute uniquement les méthodes
CreditetDebitde l'interfaceIFinancescomme opérations au contrat de service exposé. Toutes les autres méthodes sur l'interface seront omises du contrat et ne pourront pas être appelées à partir de clients de service Web.
Ajouter une interface à l’aide du mode d’hébergement Web
Exécutez ComSvcConfig avec les options
/installet/hosting:was, comme illustré dans l'exemple suivant.ComSvcConfig.exe /install /application:OnlineWarehouse /contract:ItemInventory.Warehouse,IStockLevels /hosting:was /webDirectory:root/OnlineWarehouse /mex /verboseLa commande ajoute l'interface
IStockLevelssur le composantItemInventory.Warehouse(depuis l'application COM+ OnlineWarehouse) à l'ensemble des interfaces qui seront exposées en tant que services Web. Le service étant hébergé sur le Web dans le répertoire virtuel OnlineWarehouse des services Internet (IIS) plutôt que dans COM+, l'application est activée automatiquement selon les besoins.Pour utiliser la configuration hébergée sur le Web dans un processus, l'application COM+ doit être configurée pour s'exécuter en tant qu'application bibliothèque plutôt qu'application serveur à l'aide de la console d'administration Services de composants. Les applications configurées en tant qu'applications serveur utilisent le mode hébergé sur le Web standard et effectuent un saut de processus pour traiter chaque demande.
L'option
/mexajoute un point de terminaison de service Échange de métadonnées (MEX) supplémentaire qui utilise le même transport que le point de terminaison de service de l'application pour prendre en charge les clients qui souhaitent récupérer une définition de contrat à partir du service.
Supprimer un service web pour une interface spécifiée
Exécutez ComSvcConfig avec l'option
/uninstall, comme illustré dans l'exemple suivant.ComSvcConfig.exe /uninstall /application:OnlineStore /contract:ItemOrders.Financial,IFinances /hosting:complusLa commande supprime l'interface
IFinancessur le composantItemOrders.Financial(de l'application COM+ OnlineStore).
Lister les interfaces actuellement exposées
Exécutez ComSvcConfig avec l'option
/list, comme illustré dans l'exemple suivant.ComSvcConfig.exe /listLa commande répertoire les interfaces actuellement exposées, avec l’adresse correspondante et les détails de liaison, avec comme étendue l’ordinateur local.
Lister des interfaces actuellement exposées spécifiques
Exécutez ComSvcConfig avec l'option
/list, comme illustré dans l'exemple suivant.ComSvcConfig.exe /list /application:OnlineStore /hosting:complusLa commande répertoire les interfaces hébergées par COM+ exposées actuellement, avec l’adresse correspondante et les détails de liaison, pour l’application COM+ OnlineStore sur l’ordinateur local.
Afficher de l’aide pour les options
Exécutez ComSvcConfig à l'aide de l'option /?, tel qu'illustré par l'exemple suivant.
ComSvcConfig.exe /?