Procedura: usare lo strumento di configurazione del modello di servizi di COM+

Dopo aver selezionato una modalità di hosting appropriata, utilizzare lo strumento della riga di comando per la configurazione del modello di servizi COM+ (ComSvcConfig.exe) per configurare le interfacce dell'applicazione da esporre come servizi Web.

Quando si utilizza ComSvcConfig.exe su un computer con Windows 7, attenersi alla procedura riportata di seguito per configurare un servizio Web al fine di utilizzare l'ultima versione del modello di servizi (attualmente v4.5):

1. Impostare la chiave del Registro di sistema [HKEY_LOCAL_COMPUTER\SOFTWARE\Microsoft\.NETFramework]\OnlyUseLatestCLR su un valore DWORD di 0x00000001

2. Eseguire comsvcconfig.exe

3. Ripristinare la chiave del Registro di sistema aggiunta nel passaggio 1 sul valore originale o eliminarla se non esiste.

Aggiungere un'interfaccia usando la modalità di hosting COM+

• Eseguire ComSvcConfig utilizzando le opzioni /install e /hosting:complus, come mostrato nell'esempio seguente.

  ComSvcConfig.exe /install /application:OnlineStore /contract:ItemOrders.Financial,IFinances /hosting:complus /verbose
  

  Il comando aggiunge l'interfaccia IFinances del componente ItemOrders.IFinancial dell'applicazione COM+ OnlineStore al set di interfacce da esporre come servizi Web. Il servizio utilizza la modalità di hosting COM+ e pertanto richiede l’attivazione esplicita dell'applicazione.

  Qualora sia necessario esporre solo determinate funzionalità come Servizio Web, evitare di utilizzare il carattere jolly (*) per il componente e l'interfaccia. Se si esegue l'applicazione con una versione successiva di questo componente, l'utilizzo del carattere jolly può comportare l'esposizione indesiderata delle interfacce non presenti al momento della determinazione della sintassi di configurazione.

  L'opzione /verbose consente di visualizzare sia gli avvisi sia gli errori.

  Il contratto del servizio esposto contiene tutti i metodi dell'interfaccia IFinances.

Aggiungere metodi specifici da un'interfaccia usando la modalità di hosting COM+

• Eseguire ComSvcConfig utilizzando le opzioni /install e /hosting:complus denominando in modo esplicito i metodi da aggiungere, come mostrato nell'esempio seguente.

  ComSvcConfig.exe /install /application:OnlineStore /contract:ItemOrders.Financial,IFinances.{Credit,Debit} /hosting:complus /verbose
  

  Il comando aggiunge come operazioni al contratto del servizio esposto solo i metodi Credit e Debit dell'interfaccia IFinances. Tutti gli altri metodi dell'interfaccia vengono omessi dal contratto e non sono chiamabili dai client del servizio Web.

Aggiungere un'interfaccia usando la modalità di hosting Web

• Eseguire ComSvcConfig utilizzando le opzioni /install e /hosting:was, come mostrato nell'esempio seguente.

  ComSvcConfig.exe /install /application:OnlineWarehouse /contract:ItemInventory.Warehouse,IStockLevels /hosting:was /webDirectory:root/OnlineWarehouse /mex /verbose
  

  Questo comando aggiunge l'interfaccia IStockLevels del componente ItemInventory.Warehouse dell'applicazione COM+ OnlineWarehouse al set di interfacce da esporre come servizi Web. Il servizio è ospitato su Web nella directory virtuale dell'applicazione OnlineWarehouse di IIS anziché in COM+. L'applicazione viene pertanto attivata automaticamente secondo le esigenze.

  Per utilizzare la configurazione host Web in corso occorre utilizzare la console di amministrazione di Component Services allo scopo di configurare l'applicazione COM+ affinché funzioni come applicazione libreria anziché come applicazione server. Le applicazioni configurate come applicazioni server utilizzano la modalità host Web standard e prevedono un hop di processo per elaborare ogni richiesta.

  L'opzione /mex aggiunge un endpoint di servizio di scambio metadati (MEX, Metadata Exchange) che utilizza lo stesso trasporto utilizzato dall'endpoint di servizio dell'applicazione per supportare i client che desiderano recuperare una definizione di contratto dal servizio.

Rimuovere un servizio Web di un'interfaccia specificata

• Eseguire ComSvcConfig utilizzando l'opzione /uninstall, come mostrato nell'esempio seguente.

  ComSvcConfig.exe /uninstall /application:OnlineStore /contract:ItemOrders.Financial,IFinances /hosting:complus
  

  Il comando rimuove l'interfaccia IFinances del componente ItemOrders.Financial dell'applicazione COM+ OnlineStore.

Elencare le interfacce attualmente esposte

• Eseguire ComSvcConfig utilizzando l'opzione /list, come mostrato nell'esempio seguente.

  ComSvcConfig.exe /list
  

  Il comando elenca le interfacce attualmente esposte nell'ambito del computer locale, insieme all'indirizzo e ai dettagli di associazione corrispondenti.

Elencare determinate interfacce attualmente esposte

• Eseguire ComSvcConfig utilizzando l'opzione /list, come mostrato nell'esempio seguente.

  ComSvcConfig.exe /list /application:OnlineStore /hosting:complus
  

  Il comando elenca le interfacce ospitate in COM+ attualmente esposte, insieme all'indirizzo e ai dettagli di associazione corrispondenti, relative all'applicazione COM+ OnlineStore contenuta nel computer locale.

Visualizzare la Guida per le opzioni

• Eseguire ComSvcConfig utilizzando l'opzione /? come mostrato nell'esempio seguente.

  ComSvcConfig.exe /?
  

Vedi anche

• Panoramica dell'integrazione con applicazioni COM+