CallbackDebugBehavior.IncludeExceptionDetailInFaults Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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, setPublic Property IncludeExceptionDetailInFaults As BooleanValore della proprietà
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
Aggiungere un
behaviorConfigurationattributo 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> .Aggiungere o creare una <sezione endpointBehaviors> e aggiungere un <elemento di comportamento> a tale con il nome corrispondente al valore dell'attributo
behaviorConfigurationdal passaggio 1. I comportamenti degli endpoint vengono aggiunti per l'uso in un elemento endpoint client <usando un elemento endpointBehaviors>>.<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.
