CallbackDebugBehavior.IncludeExceptionDetailInFaults Proprietà

Definizione

Spazio dei nomi:

System.ServiceModel.Description

Assembly:

System.ServiceModel.Primitives.dll

Pacchetto:

System.ServiceModel.Primitives v8.0.0

Origine:

CallbackDebugBehavior.cs

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

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à

Boolean

true se WCF restituisce le informazioni sulle eccezioni di callback client gestite negli errori SOAP per scopi di debug del servizio nelle comunicazioni 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 sull'eccezione gestita 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 proprietà IncludeExceptionDetailInFaults su true da un file di configurazione dell'applicazione o a livello di programmazione per abilitare il flusso di informazioni sulle eccezioni gestite in un oggetto callback client diretto al servizio a scopo di debug.

Attenzione

La restituzione ai servizi delle informazioni sulle eccezioni gestite può rappresentare un rischio per la sicurezza, poiché i dettagli delle eccezioni espongono informazioni sull'implementazione del client interno utilizzabili da servizi non autorizzati. Inoltre, sebbene le proprietà CallbackDebugBehavior possono essere impostate anche a livello di programmazione, può essere facile dimenticare di disattivare IncludeExceptionDetailInFaults quando si esegue la distribuzione.

A causa dei problemi di sicurezza coinvolti, è consigliato:

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

• Si procede in questo modo solo negli scenari di debug controllati.

Per altre informazioni sui problemi di sicurezza correlati alle informazioni sulle eccezioni gestite, vedere Specificare e gestire gli errori in Contratti e servizi.

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

1. Aggiungere un behaviorConfiguration attributo all'elemento endpoint> client per l'applicazione client< WCF. Il comportamento CallbackDebugBehavior è 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 con il nome corrispondente al valore dell'attributo behaviorConfiguration dal 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 relativa agli esempi. È anche possibile impostare i valori di questo attributo usando l'elemento <callbackDebug> in un file di configurazione dell'applicazione client.