Sdílet prostřednictvím

Chování ladění služby

  • Článek

Ukázka ServiceDebug ukazuje, jak lze nakonfigurovat nastavení chování ladění služby. Ukázka je založená na začínáme, který implementuje ICalculator kontrakt služby. 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á Internetová informační služba (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 může includeExceptionDetailsInFaults dojít k true ú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. Tím se stránka nápovědy vrátí do požadavku 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ělit") selže s výjimkou dělení nulou.

Nastavení, sestavení a spuštění ukázky

  1. Ujistěte se, že jste pro ukázky windows Communication Foundation provedli jednorázovou instalační proceduru.

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

  3. Pokud chcete spustit ukázku v konfiguraci s jedním nebo více počítači, postupujte podle pokynů v části Spuštění ukázek windows Communication Foundation.