CallbackDebugBehavior Classe

Referência

Definição

Namespace:: System.ServiceModel.Description

Assembly:: System.ServiceModel.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Permite a depuração de serviço para um objeto de retorno de chamada do Windows Communication Foundation (WCF).

public ref class CallbackDebugBehavior : System::ServiceModel::Description::IEndpointBehavior

public class CallbackDebugBehavior : System.ServiceModel.Description.IEndpointBehavior

type CallbackDebugBehavior = class
    interface IEndpointBehavior

Public Class CallbackDebugBehavior
Implements IEndpointBehavior

Herança: Object
CallbackDebugBehavior

Implementações: IEndpointBehavior

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>

Comentários

Defina a IncludeExceptionDetailInFaults propriedade como true de um arquivo de configuração de aplicativo ou programaticamente para habilitar o fluxo de informações de exceção gerenciadas em um objeto de retorno de chamada do cliente de volta para o serviço para fins de depuração.

Cuidado

Retornar informações de exceção gerenciadas aos serviços pode ser um risco de segurança porque os detalhes da exceção expõem informações sobre a implementação interna do cliente que podem ser usadas por serviços não autorizados. Além disso, embora as CallbackDebugBehavior propriedades também possam ser definidas programaticamente, pode ser fácil esquecer de desabilitar IncludeExceptionDetailInFaults ao implantar.

Devido aos problemas de segurança envolvidos, é altamente recomendável que:

Você usa um arquivo de configuração de aplicativo para definir o valor da IncludeExceptionDetailInFaults propriedade como true.
Você só faz isso em cenários de depuração controlada.

Para obter mais informações sobre os problemas de segurança relacionados a informações de exceção gerenciadas, consulte Especificando e tratando falhas em contratos e serviços.

Você também pode definir os valores desse atributo usando o <elemento callbackDebug> em um arquivo de configuração de aplicativo cliente.

Construtores

CallbackDebugBehavior(Boolean)

Inicializa uma nova instância da classe CallbackDebugBehavior.

Propriedades

IncludeExceptionDetailInFaults

Obtém ou define um valor que controla se os objetos de retorno de chamada do cliente retornam informações de exceção gerenciada em falhas SOAP para o serviço.

Métodos

Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Implantações explícitas de interface

IEndpointBehavior.AddBindingParameters(ServiceEndpoint, BindingParameterCollection)	Implementa o método AddBindingParameters(ServiceEndpoint, BindingParameterCollection) para dar suporte ao comportamento.
IEndpointBehavior.ApplyClientBehavior(ServiceEndpoint, ClientRuntime)	Implementa o ApplyClientBehavior(ServiceEndpoint, ClientRuntime) para dar suporte ao comportamento.
IEndpointBehavior.ApplyDispatchBehavior(ServiceEndpoint, EndpointDispatcher)	Implementa o ApplyDispatchBehavior(ServiceEndpoint, EndpointDispatcher) para dar suporte ao comportamento.
IEndpointBehavior.Validate(ServiceEndpoint)	Implementa o Validate(ServiceEndpoint) para dar suporte ao comportamento.

Aplica-se a

Compartilhar via