CallbackDebugBehavior.IncludeExceptionDetailInFaults Eigenschap

Definitie

Naamruimte:
System.ServiceModel.Description
Assembly:
System.ServiceModel.dll

Hiermee wordt een waarde opgehaald of ingesteld waarmee wordt bepaald of client callback-objecten beheerde uitzonderingsgegevens retourneren in SOAP-fouten terug naar de service.

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

Waarde van eigenschap

Boolean

true als WCF back-upinformatie voor beheerde clients retourneert in de SOAP-fouten voor servicefoutopsporingsdoeleinden in duplexcommunicatie; anders, false. De standaardwaarde is false.

Voorbeelden

In het volgende codevoorbeeld ziet u een clientconfiguratiebestand waarin WCF wordt geïnstrueerd om beheerde uitzonderingsgegevens van een client callback-object in SOAP-berichten te retourneren.

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

Opmerkingen

Stel de IncludeExceptionDetailInFaults eigenschap true in op van een toepassingsconfiguratiebestand of programmatisch om de stroom van beheerde uitzonderingsgegevens in een client callback-object terug te zetten naar de service voor foutopsporing.

Caution

Het retourneren van informatie over beheerde uitzonderingen aan services kan een beveiligingsrisico zijn, omdat uitzonderingsdetails informatie weergeven over de interne client-implementatie die kan worden gebruikt door niet-geautoriseerde services. Hoewel de CallbackDebugBehavior eigenschappen ook programmatisch kunnen worden ingesteld, kan het gemakkelijk zijn om IncludeExceptionDetailInFaults te vergeten uit te schakelen bij het implementeren.

Vanwege de betrokken beveiligingsproblemen wordt ten zeere aangeraden:

  • U gebruikt een toepassingsconfiguratiebestand om de waarde van de IncludeExceptionDetailInFaults eigenschap in te stellen op true.

  • U doet dit alleen in beheerde foutopsporingsscenario's.

Zie Fouten opgeven en afhandelen in contracten en services voor meer informatie over de beveiligingsproblemen met betrekking tot beheerde uitzonderingsinformatie.

Een functie van CallbackDebugBehavior in- of uitschakelen met behulp van een configuratiebestand

  1. Voeg een behaviorConfiguration kenmerk toe aan het clienteindpuntelement<> voor uw WCF-clienttoepassing. Het CallbackDebugBehavior gedrag is een eindpuntgedrag. Eindpuntgedrag wordt geconfigureerd op <endpoint> elementen; servicegedrag wordt geconfigureerd op <service-elementen> .

  2. Voeg een <endpointBehaviors-sectie> toe aan of maak er een <gedragselement> aan toe met de naam die overeenkomt met de behaviorConfiguration kenmerkwaarde uit stap 1. Eindpuntgedrag wordt toegevoegd voor gebruik in een clienteindpuntelement<> met behulp van een <endpointBehaviors-element>.

  3. Voeg een callbackDebug-element<> toe aan het <gedragselement> uit stap 2 en schakel de verschillende eigenschappen in of uit die geschikt zijn voor uw scenario.

Zie de sectie Voorbeeld voor een specifiek voorbeeld. U kunt ook de waarden van dit kenmerk instellen met behulp van het <callbackDebug-element> in een clienttoepassingsconfiguratiebestand.

Van toepassing op