CallbackDebugBehavior Classe

Definição

Espaço de Nomes:

System.ServiceModel.Description

Assemblagem:

System.ServiceModel.dll

Permite a depuração de serviços para um objeto de callback 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>

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.

Atenção

Devolver informação de exceção gerida aos serviços pode ser um risco de segurança porque os detalhes das exceções 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 desativar IncludeExceptionDetailInFaults durante a implantaçã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.

Também pode definir os valores deste atributo usando o <elemento callbackDebug> num ficheiro de configuração de uma aplicação cliente.

Construtores

Name	Description
CallbackDebugBehavior(Boolean)	Inicializa uma nova instância da CallbackDebugBehavior classe.

Propriedades

Name	Description
IncludeExceptionDetailInFaults	Recebe ou define um valor que controla se os objetos de callback do cliente retornam informação de exceção gerida em falhas SOAP de volta ao serviço.

Métodos

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

Implementações de Interface Explícita

Name	Description
IEndpointBehavior.AddBindingParameters(ServiceEndpoint, BindingParameterCollection)	Implementa o AddBindingParameters(ServiceEndpoint, BindingParameterCollection) método para apoiar o comportamento.
IEndpointBehavior.ApplyClientBehavior(ServiceEndpoint, ClientRuntime)	Implementa o ApplyClientBehavior(ServiceEndpoint, ClientRuntime) para apoiar o comportamento.
IEndpointBehavior.ApplyDispatchBehavior(ServiceEndpoint, EndpointDispatcher)	Implementa o ApplyDispatchBehavior(ServiceEndpoint, EndpointDispatcher) para apoiar o comportamento.
IEndpointBehavior.Validate(ServiceEndpoint)	Implementos Validate(ServiceEndpoint) para apoiar o comportamento.