CallbackDebugBehavior.IncludeExceptionDetailInFaults Egenskap

Definition

Namnområde:
System.ServiceModel.Description
Sammansättning:
System.ServiceModel.dll

Hämtar eller anger ett värde som styr om klientåteranropsobjekt returnerar hanterad undantagsinformation i SOAP-fel tillbaka till tjänsten.

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

Egenskapsvärde

Boolean

trueom WCF returnerar information om undantag för hanterad klientåteranrop i SOAP-fel för tjänstfelsökning i dubbelsidig kommunikation; annars . false Standardvärdet är false.

Exempel

I följande kodexempel visas en klientkonfigurationsfil som instruerar WCF att returnera hanterad undantagsinformation från ett klientanropsobjekt i SOAP-meddelanden.

  <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>

Kommentarer

IncludeExceptionDetailInFaults Ange egenskapen till true från en programkonfigurationsfil eller programmatiskt för att aktivera flödet av hanterad undantagsinformation i ett klientåteranropsobjekt tillbaka till tjänsten i felsökningssyfte.

Caution

Att returnera hanterad undantagsinformation till tjänster kan vara en säkerhetsrisk eftersom undantagsinformationen visar information om den interna klientimplementeringen som kan användas av obehöriga tjänster. Även om CallbackDebugBehavior egenskaperna också kan ställas in programmatiskt kan det vara lätt att glömma att inaktivera IncludeExceptionDetailInFaults när du distribuerar.

På grund av de säkerhetsproblem som är inblandade rekommenderar vi starkt att:

  • Du använder en programkonfigurationsfil för att ange värdet för IncludeExceptionDetailInFaults egenskapen till true.

  • Det gör du bara i kontrollerade felsökningsscenarier.

Mer information om säkerhetsproblem som rör hanterad undantagsinformation finns i Ange och hantera fel i Kontrakt och tjänster.

Aktivera eller inaktivera en funktion i CallbackDebugBehavior med hjälp av en konfigurationsfil

  1. Lägg till ett behaviorConfiguration attribut till klientslutpunktselementet<> för ditt WCF-klientprogram. Beteendet CallbackDebugBehavior är ett slutpunktsbeteende. Slutpunktsbeteenden konfigureras för <endpoint> element. Tjänstbeteenden konfigureras på <tjänstelement> .

  2. Lägg till i eller skapa ett <endpointBehaviors-avsnitt> och lägg till ett <beteendeelement> till det med det namn som matchar behaviorConfiguration attributvärdet från steg 1. Slutpunktsbeteenden läggs till för användning i ett klientslutpunktselement<> med hjälp av ett <endpointBehaviors-element>.

  3. Lägg till ett <callbackDebug-element> i <beteendeelementet> från steg 2 och aktivera eller inaktivera de olika egenskaper som är lämpliga för ditt scenario.

Ett specifikt exempel finns i avsnittet Exempel. Du kan också ange värdena för det här attributet med hjälp <av callbackDebug-elementet> i en klientprogramkonfigurationsfil.

Gäller för