ServiceDebugBehavior Classe

Definizione

public ref class ServiceDebugBehavior : System::ServiceModel::Description::IServiceBehavior

public class ServiceDebugBehavior : System.ServiceModel.Description.IServiceBehavior

type ServiceDebugBehavior = class
    interface IServiceBehavior

Public Class ServiceDebugBehavior
Implements IServiceBehavior

Ereditarietà

Object

ServiceDebugBehavior

Implementazioni

IServiceBehavior

Esempio

Nell'esempio di codice seguente viene illustrato come usare un file di configurazione per abilitare la funzionalità della pagina della Guida HTML e restituire le informazioni sulle eccezioni all'interno di un errore SOAP al client a scopo di debug, oltre ad abilitare il supporto dei metadati. Questo file di configurazione illustra i passaggi di base seguenti per aggiungere il supporto per le ServiceDebugBehavior funzionalità:

• Poiché il ServiceDebugBehavior tipo è un'implementazione System.ServiceModel.Description.IServiceBehavior , l'elemento <del servizio> che rappresenta il tipo di servizio ha un identificatore di configurazione del comportamento di behaviorConfiguration="metadataAndDebug".

• Poiché il ServiceDebugBehavior tipo è un'implementazione di System.ServiceModel.Description.IServiceBehavior un <elemento di comportamento> viene aggiunto a una <sezione serviceBehaviors> . Impostare l'attributo dell'elemento name<di comportamento> il cui valore è l'identificatore dell'attributo dell'elemento behaviorConfiguration<del servizio> . In questo caso, il valore è metadataAndDebug.

• Aggiungere un <elemento serviceDebug> con i vari attributi impostati sulla configurazione desiderata. In questo caso, i valori dell'attributo httpHelpPageEnabled e includeExceptionDetailInFaults vengono impostati su true.

<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

Utilizzare le ServiceDebugBehavior proprietà di un file di configurazione o a livello di codice per abilitare il flusso di informazioni sulle eccezioni gestite al client a scopo di debug, nonché la pubblicazione di file di informazioni HTML per gli utenti che esplorano il servizio nei Web browser.

Impostare la IncludeExceptionDetailInFaults proprietà su true per indicare a WCF di restituire informazioni sulle eccezioni gestite negli errori SOAP ai client a scopo di debug.

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.

Le HttpHelpPageEnabled proprietà e HttpsHelpPageEnabled indicano al servizio di pubblicare file della Guida HTML quando il servizio viene visualizzato usando un browser HTML.

Le HttpHelpPageUrl proprietà e HttpsHelpPageUrl controllano la posizione della pagina della Guida HTML visualizzata.

Per abilitare o disabilitare una delle funzionalità usando un file di ServiceDebugBehavior configurazione:

1. Aggiungere un behaviorConfiguration attributo all'elemento <del servizio> per il servizio WCF. I comportamenti degli endpoint vengono configurati sugli <elementi dell'endpoint> ; i comportamenti del servizio sugli <elementi del servizio> .

2. Aggiungere o creare una <sezione serviceBehaviors> 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 configurati usando un <elemento endpointBehaviors> . I comportamenti del servizio vengono configurati usando un <elemento serviceBehaviors> .

3. Aggiungere un <elemento serviceDebug> 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.