Condividi tramite


CallbackDebugBehavior.IncludeExceptionDetailInFaults Proprietà

Definizione

Ottiene o imposta un valore che controlla se gli oggetti di callback client restituiscono informazioni sulle eccezioni gestite negli errori SOAP al servizio.

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

Valore della proprietà

true se WCF restituisce informazioni sulle eccezioni di callback client gestite negli errori SOAP a scopo di debug del servizio nella comunicazione duplex; in caso contrario, false. Il valore predefinito è false.

Esempio

Nell'esempio di codice seguente viene illustrato un file di configurazione client che indica a WCF di restituire informazioni sulle eccezioni gestite da un oggetto callback client nei messaggi 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>

Commenti

Impostare la IncludeExceptionDetailInFaults proprietà su true da un file di configurazione dell'applicazione o a livello di codice per abilitare il flusso di informazioni sulle eccezioni gestite in un oggetto callback client al servizio a scopo di debug.

Attenzione

La restituzione di informazioni sulle eccezioni gestite ai servizi può essere un rischio per la sicurezza perché i dettagli delle eccezioni espongono informazioni sull'implementazione client interna che potrebbero essere usate da servizi non autorizzati. Inoltre, anche se le CallbackDebugBehavior proprietà possono essere impostate anche programmaticamente, può essere facile dimenticare di disabilitare IncludeExceptionDetailInFaults durante la distribuzione.

A causa dei problemi di sicurezza coinvolti, è consigliabile:

  • Usare un file di configurazione dell'applicazione per impostare il valore della IncludeExceptionDetailInFaults proprietà su true.

  • Questa operazione viene eseguita solo in scenari di debug controllati.

Per altre informazioni sui problemi di sicurezza relativi alle informazioni sulle eccezioni gestite, vedere Impostazione e gestione degli errori in Contratti e servizi.

Per abilitare o disabilitare una funzionalità di CallbackDebugBehavior usando un file di configurazione

  1. Aggiungere un behaviorConfiguration attributo all'elemento endpoint> client< per l'applicazione client WCF. Il CallbackDebugBehavior comportamento è un comportamento dell'endpoint. I comportamenti degli endpoint vengono configurati sugli <endpoint> elementi. I comportamenti del servizio vengono configurati sugli <elementi del servizio> .

  2. Aggiungere o creare una <sezione endpointBehaviors> e aggiungere un <elemento di comportamento> a tale elemento con il nome che corrisponde al valore dell'attributo del behaviorConfiguration passaggio 1. I comportamenti degli endpoint vengono aggiunti per l'uso in un elemento endpoint> client< usando un <elemento endpointBehaviors>.

  3. Aggiungere un <elemento callbackDebug> all'elemento <di comportamento> del passaggio 2 e abilitare o disabilitare le varie proprietà appropriate per lo scenario.

Per un esempio specifico, vedere la sezione Esempio. È anche possibile impostare i valori di questo attributo usando l'elemento <callbackDebug> in un file di configurazione dell'applicazione client.

Si applica a