ServiceDebugBehavior.IncludeExceptionDetailInFaults Propriedade

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

Valor de Propriedade

true se Windows Communication Foundation (WCF) devolver informação de exceção gerida nas falhas SOAP para efeitos de depuração do cliente; caso contrário, false. A predefinição é false.

Exemplos

O seguinte exemplo de código mostra como usar um ficheiro de configuração para ativar a funcionalidade da página de ajuda HTML e devolver informação de exceção dentro de uma falha SOAP ao cliente para efeitos de depuração. Este ficheiro de configuração mostra os seguintes passos básicos para adicionar suporte às ServiceDebugBehavior funcionalidades:

• Como o ServiceDebugBehavior tipo é uma System.ServiceModel.Description.IServiceBehavior implementação, o <elemento de serviço> que representa o tipo de serviço tem um identificador de configuração de comportamento de behaviorConfiguration="metadataAndDebug".

• Mais uma vez, porque o ServiceDebugBehavior tipo é uma System.ServiceModel.Description.IServiceBehavior implementação, um <elemento de comportamento> é adicionado a uma <secção ServiceBehaviors> . Defina o name atributo do <elemento de comportamento> cujo valor é o identificador do behaviorConfiguration atributo do <elemento de serviço> . Neste caso, o valor é metadataAndDebug.

• Adicione um <elemento serviceDebug> com os vários atributos definidos para a configuração desejada. Neste caso, os httpHelpPageEnabled valores do atributo e includeExceptionDetailInFaults são definidos como 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>

Observações

Defina a IncludeExceptionDetailInFaults propriedade para true instruir o WCF a devolver informações de exceções geridas ao cliente em falhas SOAP para facilitar a depuração.

Devido às questões de segurança envolvidas, recomenda-se vivamente que:

• Use um ficheiro de configuração da aplicação para definir o valor da propriedade IncludeExceptionDetailInFaults como true.

• Só o fazes em cenários de depuração controlados.

Para obter mais informações, consulte Especificando e tratando falhas em contratos e serviços.