Procedura: utilizzare 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.

Per aggiungere un'interfaccia all'insieme di interfacce da esporre come servizi Web mediante 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 all'insieme 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.

Per aggiungere solo determinati metodi di un'interfaccia all'insieme di interfacce da esporre come servizi Web mediante 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.

Per aggiungere un'interfaccia all'insieme di interfacce da esporre come servizi Web mediante la modalità host 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 all'insieme 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.

Per 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.

Per 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.

Per 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.

Per visualizzare la Guida relativa alle opzioni disponibili nell'utilità

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

  ComSvcConfig.exe /?
  

Vedere anche

Concetti

Panoramica sull'integrazione con applicazioni COM+