Chování ladění služby
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
natrue
. 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 ktrue
ú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
natrue
. 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 atributuhttpHelpPageUrl
. Tuto možnost můžete zabezpečit pomocí protokolu HTTPS místo protokolu HTTP. To lze provést nastavenímhttpsHelpPageEnabled
ahttpsHelpPageUrl
.
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
Ujistěte se, že jste pro ukázky windows Communication Foundation provedli jednorázovou instalační proceduru.
Pokud chcete sestavit edici C# nebo Visual Basic .NET řešení, postupujte podle pokynů v části Sestavení ukázek windows Communication Foundation.
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.