Postupy: Použití nástroje pro konfiguraci modelu služby COM+

Jakmile vyberete vhodný režim hostování, pomocí nástroje příkazového řádku konfigurace modelu služby COM+ (ComSvcConfig.exe) nakonfigurujte aplikační rozhraní, která budou zpřístupněna jako webové služby.

Poznámka:

Abyste mohli provádět některé z následujících úloh, musíte být na počítači správcem.

Při použití ComSvcConfig.exe na počítači s Windows 7 nakonfigurujte webovou službu tak, aby používala nejnovější verzi modelu služby (aktuálně v4.5), proveďte následující kroky:

1. Nastavení klíče [HKEY_LOCAL_COMPUTER\SOFTWARE\Microsoft\.NETFramework]\OnlyUseLatestCLR registru na hodnotu DWORD 0x00000001

2. Spuštění comsvcconfig.exe

3. Vraťte klíč registru přidaný v kroku 1 zpět na původní hodnotu nebo ho odstraňte, pokud neexistuje.

Důležité

Vrácení tohoto klíče registru je důležité. Toto je klíč kompatibility. Vrácení této změny může způsobit problémy s jinými aplikacemi .NET spuštěnými na počítači).

Upozorňující

Při použití ComSvcConfig.exe /install na počítači s Windows 8 se zobrazí dialogové okno s informacemi o tom, že aplikace na vašem počítači potřebuje následující funkci Windows: .NET Framework 3.5 (zahrnuje .NET 2.0 a .NET 3.0), pokud rozhraní .NET Framework 3.5 není nainstalované. Toto dialogové okno může být ignorováno. Alternativně můžete použít klíč registru OnlyUseLatestCLR k hodnotě DWORD 0x00000001

Přidání rozhraní pomocí režimu hostování modelu COM+

• Spusťte ComSvcConfig pomocí /install a /hosting:complus možností, jak je znázorněno v následujícím příkladu.

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

  Příkaz přidá IFinances rozhraní ItemOrders.IFinancial komponenty (z aplikace MODELU COM+ OnlineStore) do sady rozhraní, která budou vystavena jako webové služby. Služba používá režim hostování modelu COM+ a proto vyžaduje explicitní aktivaci aplikace.

  Znak hvězdičky (*) se dá použít pro komponentu a rozhraní, ale nepoužívejte ho, protože byste mohli chtít zpřístupnit pouze vybrané funkce jako webovou službu. Pokud se spustí s budoucí verzí této komponenty, může použití zástupného znaku neúmyslně vystavit rozhraní, která se nemusí vyskytovat při určení syntaxe konfigurace.

  Možnost /verbose dává nástroji pokyn, aby kromě chyb zobrazoval upozornění.

  Kontrakt pro vystavenou službu bude obsahovat všechny metody z IFinances rozhraní.

Přidání konkrétních metod z rozhraní pomocí režimu hostování modelu COM+

• Spusťte ComSvcConfig pomocí /install a /hosting:complus možností s explicitním pojmenováním požadovaných metod, jak je znázorněno v následujícím příkladu.

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

  Příkaz přidá do vystaveného kontraktu IFinances služby pouze Credit metody a Debit metody z rozhraní. Všechny ostatní metody v rozhraní budou z kontraktu vynechány a nebudou volány z klientů webové služby.

Přidání rozhraní pomocí režimu hostování webu

• Spusťte ComSvcConfig pomocí /install možnosti a /hosting:was možnosti, jak je znázorněno v následujícím příkladu.

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

  Příkaz přidá IStockLevels rozhraní komponenty ItemInventory.Warehouse (z aplikace Com+ OnlineWarehouse COM+) do sady rozhraní, která budou vystavena jako webové služby. Služba je web hostovaná ve virtuálním adresáři služby IIS OnlineWarehouse, nikoli v modelu COM+, a proto je aplikace automaticky aktivována podle potřeby.

  Aby bylo možné použít konfiguraci v rámci procesu hostované na webu, musí být aplikace modelu COM+ nakonfigurovaná tak, aby běžela jako aplikace knihovny, a ne jako serverová aplikace pomocí konzoly pro správu služby Component Services. Aplikace nakonfigurované jako serverové aplikace používají standardní režim hostovaný webem a pro zpracování jednotlivých požadavků se účtují segmenty směrování procesu.

  Tato /mex možnost přidá další koncový bod služby MeX (Metadata Exchange), který používá stejný přenos jako koncový bod služby aplikace pro podporu klientů, kteří chtějí ze služby načíst definici kontraktu.

Odebrání webové služby pro zadané rozhraní

• Spusťte comSvcConfig pomocí /uninstall možnosti, jak je znázorněno v následujícím příkladu.

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

  Příkaz odebere IFinances rozhraní komponenty ItemOrders.Financial (z aplikace MODELU COM+ OnlineStore).

Seznam aktuálně vystavených rozhraní

• Spusťte comSvcConfig pomocí /list možnosti, jak je znázorněno v následujícím příkladu.

  ComSvcConfig.exe /list
  

  Příkaz zobrazí seznam aktuálně vystavených rozhraní spolu s odpovídajícími podrobnostmi adresy a vazby, které jsou vymezeny na místní počítač.

Výpis konkrétních aktuálně vystavených rozhraní

• Spusťte comSvcConfig pomocí /list možnosti, jak je znázorněno v následujícím příkladu.

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

  Příkaz vypíše aktuálně vystavená rozhraní COM+hostovaná společně s odpovídajícími adresami a podrobnostmi vazby pro aplikaci Modelu COM+ OnlineStore na místním počítači.

Zobrazit nápovědu k možnostem

• Spusťte comSvcConfig pomocí příkazu /? jak je znázorněno v následujícím příkladu.

  ComSvcConfig.exe /?
  

Viz také

• Přehled integrace s aplikacemi modelu COM+