CallbackDebugBehavior.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 o WCF devolve informação de exceção de callback de cliente gerido nas falhas SOAP para fins de depuração de serviço em comunicação duplex; caso contrário, false. A predefinição é false.

Exemplos

O exemplo de código a seguir mostra um arquivo de configuração do cliente que instrui o WCF a retornar informações de exceção gerenciadas de um objeto de retorno de chamada do cliente em mensagens 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>

Observações

Defina a IncludeExceptionDetailInFaults propriedade a true partir de um ficheiro de configuração de aplicação ou programaticamente para permitir o fluxo de informação de exceções geridas num objeto de callback cliente de volta ao serviço para fins de 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 mais informações sobre as questões de segurança relacionadas com exceções geridas, consulte Especificação e Gestão de Falhas em Contratos e Serviços.

Para ativar ou desativar uma funcionalidade do CallbackDebugBehavior usando um ficheiro de configuração

1. Adicione um behaviorConfiguration atributo ao elemento endpoint< do cliente> para a sua aplicação cliente WCF. O CallbackDebugBehavior comportamento é um comportamento de endpoint. Os comportamentos dos endpoints são configurados em <endpoint> elementos; os comportamentos de serviço são configurados em <elementos de serviço> .

2. Adicione ou crie uma <secção endpointBehaviors> e adicione um <elemento behavior> com o nome correspondente ao behaviorConfiguration valor do atributo do passo 1. Os comportamentos dos endpoints são adicionados para utilização num elemento de endpoint< cliente> usando um <elemento endpointBehaviors>.

3. Adicione um <elemento callbackDebug> ao <elemento behavior> do passo 2 e ative ou desative as várias propriedades apropriadas ao seu cenário.

Para um exemplo específico, veja a secção Exemplo. Também pode definir os valores deste atributo usando o <elemento callbackDebug> num ficheiro de configuração de uma aplicação cliente.