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 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
Aggiungere un
behaviorConfigurationattributo 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> .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
behaviorConfigurationpassaggio 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 Esempio. È anche possibile impostare i valori di questo attributo usando l'elemento <callbackDebug> in un file di configurazione dell'applicazione client.