CallbackDebugBehavior.IncludeExceptionDetailInFaults Vlastnost

Definice

Obor názvů:

System.ServiceModel.Description

Sestavení:

System.ServiceModel.Primitives.dll

Balíček:

System.ServiceModel.Primitives v8.0.0

Zdroj:

CallbackDebugBehavior.cs

Získá nebo nastaví hodnotu, která řídí, zda objekty zpětného volání klienta vrátí informace o spravované výjimce v chybách SOAP zpět do služby.

public:
 property bool IncludeExceptionDetailInFaults { bool get(); void set(bool value); };

public bool IncludeExceptionDetailInFaults { get; set; }

member this.IncludeExceptionDetailInFaults : bool with get, set

Public Property IncludeExceptionDetailInFaults As Boolean

Hodnota vlastnosti

Boolean

truePokud WCF vrátí informace o výjimce zpětného volání spravovaného klienta v soap chyby pro účely ladění služby v duplexní komunikaci; v opačném případě . false Výchozí formát je false.

Příklady

Následující příklad kódu ukazuje konfigurační soubor klienta, který dává pokyn WCF, aby vracela informace o spravovaných výjimkách z objektu zpětného volání klienta ve zprávách SOAP.

  <client>
      <endpoint 
        address="http://localhost:8080/DuplexHello" 
        binding="wsDualHttpBinding"
        bindingConfiguration="WSDualHttpBinding_SampleDuplexHello"
        contract="SampleDuplexHello" 
        name="WSDualHttpBinding_SampleDuplexHello"
        behaviorConfiguration="enableCallbackDebug">
      </endpoint>
  </client>
<behaviors>
  <endpointBehaviors>
    <behavior name="enableCallbackDebug">
      <callbackDebug includeExceptionDetailInFaults="true"/>
    </behavior>
  </endpointBehaviors>
</behaviors>

Poznámky

IncludeExceptionDetailInFaults Nastavením vlastnosti true z konfiguračního souboru aplikace nebo programově povolíte tok informací o spravovaných výjimkách v objektu zpětného volání klienta zpět do služby pro účely ladění.

Upozornění

Vrácení informací o spravovaných výjimce službám může být bezpečnostní riziko, protože podrobnosti o výjimce zveřejňují informace o interní implementaci klienta, které by mohly použít neautorizované služby. Kromě toho, i když CallbackDebugBehavior je možné vlastnosti nastavit také programově, může být snadné zapomenout zakázat IncludeExceptionDetailInFaults při nasazení.

Kvůli souvisejícím problémům se zabezpečením důrazně doporučujeme:

• Pomocí konfiguračního souboru aplikace nastavíte hodnotu IncludeExceptionDetailInFaults vlastnosti na true.

• Provádíte to pouze ve scénářích řízeného ladění.

Další informace o problémech se zabezpečením souvisejících s informacemi o spravovaných výjimkách najdete v tématu Určení a zpracování chyb v kontraktech a službách.

Povolení nebo zakázání funkce CallbackDebugBehavior pomocí konfiguračního souboru

1. behaviorConfiguration Přidejte atribut do elementu koncového bodu> klienta< pro klientskou aplikaci WCF. Jedná se CallbackDebugBehavior o chování koncového bodu. Chování koncových bodů se konfiguruje u <endpoint> elementů, chování služeb se konfiguruje u <prvků služby> .

2. Přidejte nebo vytvořte <část endpointBehaviors> a přidejte <element behavior> s názvem, který odpovídá hodnotě atributu behaviorConfiguration z kroku 1. Chování koncového bodu jsou přidána pro použití v elementu koncového bodu> klienta< pomocí elementu <endpointBehaviors>.

3. <Přidejte element callbackDebug> do elementu <behavior> z kroku 2 a povolte nebo zakažte různé vlastnosti odpovídající vašemu scénáři.

Konkrétní příklad najdete v části Příklad. Můžete také nastavit hodnoty tohoto atributu pomocí elementu <callbackDebug> v konfiguračním souboru klientské aplikace.