Chování ladění služby

Ukázka ServiceDebug demonstruje, jak lze konfigurovat nastavení chování pro ladění služby. Ukázka je založená na Začínáme, které implementuje smlouvu o službách ICalculator. Tato ukázka explicitně definuje chování ladění služby v konfiguračním souboru. Lze ho také provést imperativním způsobem v kódu.

V této ukázce je klient konzolovou aplikací (.exe) a služba je hostovaná internetovou informační službou (IIS).

Poznámka:

Postup nastavení a pokyny k sestavení pro tuto ukázku najdete na konci tohoto tématu.

Soubor Web.config pro server definuje chování ladění služby, aby bylo možné povolit stránku nápovědy a zpracování výjimek, jak je znázorněno v následující ukázce.

<behaviors>
     <serviceBehaviors>
         <behavior name="CalculatorServiceBehavior">
         <!-- WARNING: Setting includeExceptionDetailInFaults = "True" could result in leaking secured server information to the client.-->
         <!-- Please set this to false when deploying -->
             <serviceDebug includeExceptionDetailInFaults="True" httpHelpPageEnabled="True"/>
         </behavior>
     </serviceBehaviors>
</behaviors>

<serviceDebug> je konfigurační prvek, který umožňuje změnit vlastnosti chování ladění služby. Uživatel může toto chování upravit, aby dosáhl následujícího:

• To službě umožňuje vrátit jakoukoli výjimku, která je vyvolán kódem aplikace, i když výjimka není deklarována pomocí FaultContractAttribute. Provádí se nastavením includeExceptionDetailInFaults na true. Toto nastavení je užitečné při ladění případů, kdy server vyvolává neočekávanou výjimku.

  Důležité

  Toto nastavení není bezpečné zapnout v produkčním prostředí. Neočekávaná výjimka serveru může obsahovat některé informace, které nejsou určené pro klienta, a proto nastavení includeExceptionDetailsInFaults na true může vést k úniku informací.

• ServiceDebug<> také umožňuje uživateli povolit nebo zakázat stránku nápovědy. Každá služba může volitelně zveřejnit stránku nápovědy, která obsahuje informace o službě, včetně koncového bodu pro získání WSDL pro službu. To lze povolit nastavením httpHelpPageEnabled na true. To umožňuje, aby stránka nápovědy byla vrácena jako odpověď na požadavek GET na základní adresu služby. Tuto adresu můžete změnit nastavením jiného atributu httpHelpPageUrl. Tuto možnost můžete zabezpečit pomocí protokolu HTTPS místo protokolu HTTP. To lze provést nastavením httpsHelpPageEnabled a httpsHelpPageUrl.

Při spuštění ukázky se požadavky na operace a odpovědi zobrazí v okně konzoly klienta. První tři operace (sčítání, odečítání a násobení) musí proběhnout úspěšně. Poslední operace ("dělení") selže kvůli výjimce dělení nulou.

Jak nastavit, sestavit a spustit ukázku

1. Ujistěte se, že jste provedli instalační proceduru One-Time pro ukázky Windows Communication Foundation.

2. Pokud chcete sestavit verzi C# nebo Visual Basic .NET řešení, postupujte podle pokynů v Sestavení ukázek Windows Communication Foundation.

3. Pokud chcete spustit ukázku v konfiguraci pro jeden počítač nebo pro více počítačů, postupujte podle pokynů v Spuštění ukázek Windows Communication Foundation.