ServiceDebugBehavior.IncludeExceptionDetailInFaults Proprietà

Definizione

Ottiene o imposta un valore che specifica se includere informazioni sulle eccezioni gestite nei dettagli sugli errori SOAP restituiti al client a scopo di debug.Gets or sets a value that specifies whether to include managed exception information in the detail of SOAP faults returned to the client for debugging purposes.

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 Windows Communication Foundation (WCF) restituisce informazioni sulle eccezioni gestite negli errori SOAP a scopo di debug client; in caso contrario, false .true if Windows Communication Foundation (WCF) returns managed exception information in the SOAP faults for client debugging purposes; otherwise, false. Il valore predefinito è false.The default is false.

Esempio

Nell'esempio di codice seguente viene illustrato come utilizzare un file di configurazione per l'abilitazione della funzionalità delle pagine della Guida HTML e la restituzione al client di informazioni sulle eccezioni contenute in un errore SOAP a fini di debug.The following code example shows how to use a configuration file to enable the HTML help page feature and return exception information inside a SOAP fault back to the client for debugging purposes. In questo file di configurazione vengono illustrati i seguenti passaggi di base che consentono l'aggiunta del supporto per le funzionalità di ServiceDebugBehavior:This configuration file shows the following basic steps to adding support for the ServiceDebugBehavior features:

<configuration>
  <system.serviceModel>
    <services>
      <!-- 
        Step 1. Add a behaviorConfiguration attribute
        in the <service> element.
      -->
      <service 
        name="Microsoft.WCF.Documentation.SampleService"
        behaviorConfiguration="metadataAndDebug">
        <host>
          <baseAddresses>
            <add baseAddress="http://localhost:8080/SampleService" />
          </baseAddresses>
        </host>
        <endpoint
          address=""
          binding="wsHttpBinding"
          contract="Microsoft.WCF.Documentation.ISampleService"
        />
        <endpoint
           address="mex"
           binding="mexHttpBinding"
           contract="IMetadataExchange"
        />
      </service>
    </services>
    <behaviors>
      <serviceBehaviors>
        <!-- 
          Step 2. Inside a <serviceBehaviors> section, add 
          a name attribute in the <behaviors> element that 
          matches the behaviorConfiguration attribute in the
          <service> element above.
        -->
        <behavior name="metadataAndDebug">
          <serviceMetadata 
            httpGetEnabled="true" 
            httpGetUrl=""
          />
          <!-- 
            Step 3. Add a <serviceDebug> element and 
            modify the various attributes that suit your 
            scenario.
          -->
          <serviceDebug 
            httpHelpPageEnabled="true" 
            includeExceptionDetailInFaults="true"
          />
        </behavior>
      </serviceBehaviors>
    </behaviors>
  </system.serviceModel>
</configuration>

Commenti

Impostare la IncludeExceptionDetailInFaults proprietà su true per indicare a WCF di restituire al client le informazioni sulle eccezioni gestite negli errori SOAP per semplificare il debug.Set the IncludeExceptionDetailInFaults property to true to instruct WCF to return managed exception information to the client in SOAP faults to ease debugging.

Attenzione

La restituzione ai client delle informazioni sulle eccezioni gestite può rappresentare un rischio per la sicurezza, poiché i dettagli delle eccezioni espongono informazioni sull'implementazione del servizio interno che potrebbero essere usate da client non autorizzati.Returning managed exception information to clients can be a security risk because exception details expose information about the internal service implementation that could be used by unauthorized clients. Inoltre, sebbene le proprietà ServiceDebugBehavior possono essere impostate anche a livello di programmazione, può essere facile dimenticare di disattivare IncludeExceptionDetailInFaults quando si esegue la distribuzione.In addition, although the ServiceDebugBehavior properties can also be set programmatically, it can be easy to forget to disable IncludeExceptionDetailInFaults when deploying.

A causa dei problemi di sicurezza coinvolti, è consigliato:Because of the security issues involved, it is strongly recommended that:

  • Usare un file di configurazione dell'applicazione per impostare il valore della proprietà IncludeExceptionDetailInFaults su true.You use an application configuration file to set the value of the IncludeExceptionDetailInFaults property to true.

  • Si procede in questo modo solo negli scenari di debug controllati.You only do so only in controlled debugging scenarios.

Per ulteriori informazioni, vedere specifica e gestione di errori in contratti e servizi.For more information, see Specifying and Handling Faults in Contracts and Services.

Si applica a