CallbackDebugBehavior.IncludeExceptionDetailInFaults Vlastnost

Definice

Obor názvů:

System.ServiceModel.Description

Sestavení:

System.ServiceModel.dll, System.ServiceModel.Primitives.dll

Balíček:

System.ServiceModel.Primitives v10.0.652802

Zdroj:

CallbackDebugBehavior.cs

Získá nebo nastaví hodnotu, která řídí, zda objekty zpětného volání klienta vrací spravované informace o 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 chybách SOAP pro účely ladění služby při duplexní komunikaci; v opačném případě . false Výchozí hodnota je false.

Příklady

Následující příklad kódu ukazuje konfigurační soubor klienta, který dává WCF pokyn, aby vrátil spravované informace o výjimce 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 Nastavte vlastnost z true konfiguračního souboru aplikace nebo programově povolit 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, kterou by mohly používat neoprávněné služby. Kromě toho, i když CallbackDebugBehavior je možné vlastnosti nastavit také programově, může být při nasazování snadné zapomenout zakázat IncludeExceptionDetailInFaults .

Vzhledem k problémům se zabezpečením důrazně doporučujeme:

• Konfigurační soubor aplikace slouží k nastavení hodnoty IncludeExceptionDetailInFaults vlastnosti na true.

• Provedete to jenom 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. Chování CallbackDebugBehavior je chování koncového bodu. Chování koncového bodu se konfiguruje u <endpoint> prvků. Chování služby se konfiguruje u <prvků služby> .

2. Přidejte do nebo vytvořte <oddíl endpointBehaviors> a přidejte <do toho prvek chování> s názvem, který odpovídá hodnotě atributu behaviorConfiguration z kroku 1. Chování koncového bodu se přidává pro použití v elementu koncového bodu> klienta< pomocí elementu< endpointBehaviors>.

3. Přidejte do elementu <chování element callbackDebug> z kroku 2 a povolte nebo zakažte různé vlastnosti vhodné pro váš scénář.><

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