Vorgehensweise: Verwenden des COM+-Dienstmodell-Konfigurationstools

Nachdem Sie einen geeigneten Hosting-Modus ausgewählt haben, verwenden Sie das COM+-Dienstmodell-Konfigurations-Befehlszeilentool (ComSvcConfig.exe) zur Konfigurierung der Anwendungsschnittstellen, die als Webdienste verfügbar gemacht werden.

Hinweis:
Sie müssen über Administratorrechte verfügen, um die folgenden Aufgaben auszuführen zu können.

Um mithilfe des COM+-Hostingmodus eine Schnittstelle zu der Gruppe von Schnittstellen hinzuzufügen, die als Webdienste verfügbar gemacht werden sollen.

• Führen Sie ComSvcConfig mithilfe der /install- und der /hosting:complus-Optionen aus, wie im folgenden Beispiel gezeigt.

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

  Der Befehl fügt die IFinances-Schnittstelle der ItemOrders.IFinancial-Komponente (aus der OnlineStore-COM+-Anwendung) zu der Gruppe von Schnittstellen hinzu, die als Webdienste verfügbar gemacht werden. Der Dienst verwendet den COM+-Hostingmodus und erfordert deshalb eine explizite Anwendungsaktivierung.

  Obwohl das Sternchenzeichen (*) als Platzhalter für die Komponente und die Schnittstelle verwendet werden kann, sollten Sie es vermeiden, da Sie möglicherweise nur ausgewählte Funktionen als Webdienst verfügbar machen möchten. Bei der Ausführung mit einer künftigen Version dieser Komponente kann die Verwendung des Platzhalters unbeabsichtigt Schnittstellen verfügbar machen, die noch nicht vorhanden waren, als die Konfigurationssyntax festgelegt wurde.

  Die Option für die ausführliche Ausgabe weist das Tool an, zusätzlich zu Fehlern Warnungen anzuzeigen.

  Der Vertrag für den verfügbar gemachten Dienst enthält alle Methoden aus der IFinances-Schnittstelle.

So fügen Sie der Gruppe von Schnittstellen, die als Webdienste verfügbar gemacht werden sollen, nur bestimmte Methoden einer Schnittstelle mithilfe des COM+-Hostingmodus hinzu

• Führen Sie ComSvcConfig mithilfe der /install- und der /hosting:complus-Optionen mit expliziter Benennung der erforderlichen Methoden aus, wie im folgenden Beispiel gezeigt.

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

  Der Befehl fügt nur die Credit- und die Debit-Methode der IFinances-Schnittstelle als Vorgänge zu dem verfügbar gemachten Dienstvertrag hinzu. Alle anderen Methoden der Schnittstelle erscheinen nicht im Vertrag und können von Webdienstclients nicht aufgerufen werden.

So fügen Sie einer Gruppe von Schnittstellen, die als Webdienste verfügbar gemacht werden sollen, eine Schnittstelle mithilfe des Webhostingmodus hinzu

• Führen Sie ComSvcConfig mithilfe der /install- und der /hosting:was-Option aus, wie im folgenden Beispiel gezeigt.

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

  Der Befehl fügt die IStockLevels-Schnittstelle der ItemInventory.Warehouse-Komponente (aus der OnlineWarehouse-COM+-Anwendung) zu der Gruppe von Schnittstellen hinzu, die als Webdienste verfügbar gemacht werden. Statt in COM+ wird der Dienst im virtuellen OnlineWarehouse-Verzeichnis von IIS im Internet gehostet, und folglich wird die Anwendung automatisch bei Bedarf aktiviert.

  Um die im Internet gehostete prozessinterne Konfiguration zu verwenden, muss die COM+-Anwendung mithilfe der Verwaltungskonsole Komponentendienste so konfiguriert werden, dass sie als Library-Anwendung ausgeführt wird. Anwendungen, die als Serveranwendungen konfiguriert werden, werden standardmäßig im Internet gehostet und bewirken einen Prozesshop für die Verarbeitung jeder Anforderung.

  Die /mex-Option fügt einen zusätzlichen Metadatenaustausch-Dienstendpunkt (MEX oder Metadata Exchange) hinzu, der denselben Transport verwendet wie der Dienstendpunkt der Anwendung, um Clients beim Abrufen einer Vertragsdefinition vom Dienst zu unterstützen.

Entfernen eines Webdiensts aus einer angegebenen Schnittstelle

• Führen Sie ComSvcConfig mithilfe der /uninstall-Optionen aus, wie im folgenden Beispiel gezeigt.

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

  Der Befehl entfernt die IFinances-Schnittstelle in der ItemOrders.Financial-Komponente (aus der OnlineStore-COM+-Anwendung).

So listen Sie zurzeit verfügbare Schnittstellen auf

• Führen Sie ComSvcConfig mithilfe der /list-Option aus, wie im folgenden Beispiel gezeigt.

  ComSvcConfig.exe /list
  

  Der Befehl listet die derzeit verfügbaren Schnittstellen zusammen mit den entsprechenden Adress- und Bindungsdetails auf, deren Gültigkeitsbereich der lokale Computer ist.

So listen Sie bestimmte zurzeit verfügbare Schnittstellen auf

• Führen Sie ComSvcConfig mithilfe der /list-Optionen aus, wie im folgenden Beispiel gezeigt:

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

  Der Befehl listet derzeit verfügbare COM+-gehostete Schnittstellen zusammen mit den entsprechenden Adress- und Bindungsdetails für die OnlineStore-COM+-Anwendung auf dem lokalen Computer auf.

So zeigen Sie Hilfe in den Optionen an, die mit dem Hilfsprogramm verwendet werden können

• Führen Sie ComSvcConfig mithilfe der /? -Option aus, wie im folgenden Beispiel gezeigt.

  ComSvcConfig.exe /?
  

Siehe auch

Konzepte

Übersicht über die Integration von COM+-Anwendungen