CallbackDebugBehavior.IncludeExceptionDetailInFaults Propiedad

Definición

Espacio de nombres:

System.ServiceModel.Description

Ensamblado:

System.ServiceModel.dll

Obtiene o establece un valor que controla si los objetos de devolución de llamada de cliente devuelven información de excepción administrada en errores SOAP al servicio.

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 propiedad

Boolean

true si WCF devuelve información de excepción de devolución de llamada de cliente administrado en los errores SOAP con fines de depuración de servicios en comunicación dúplex; de lo contrario, false. De manera predeterminada, es false.

Ejemplos

En el ejemplo de código siguiente se muestra un archivo de configuración de cliente que indica a WCF que devuelva información de excepción administrada de un objeto de devolución de llamada de cliente en mensajes 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>

Comentarios

Establece la propiedad IncludeExceptionDetailInFaults como true desde un archivo de configuración de la aplicación o mediante programación para permitir el flujo de información en un objeto de devolución de llamada al cliente en el servicio con fines depurativos.

Precaución

Devolver la información de excepción administrada a los servicios puede suponer un riesgo para la seguridad porque los datos de la excepción exponen información sobre la implementación del cliente interna que los servicios desautorizados podrían utilizar. Además, aunque también se pueden establecer las propiedades CallbackDebugBehavior mediante programación, puede ser fácil olvidarse de deshabilitar IncludeExceptionDetailInFaults en la implementación.

Debido a los problemas de seguridad implicados, se recomienda encarecidamente que:

• Utilice un archivo de configuración de la aplicación para establecer el valor de la propiedad IncludeExceptionDetailInFaults en true.

• Hágalo solamente en escenarios de depuración controlados.

Para obtener más información sobre los problemas de seguridad relacionados con la información de excepciones administradas, consulte Especificación y control de errores en contratos y servicios.

Habilitar o deshabilitar una característica de CallbackDebugBehavior utilizando un archivo de configuración

1. Agregue un behaviorConfiguration atributo al elemento cliente <endpoint> para la aplicación cliente wcF. El comportamiento CallbackDebugBehavior es un comportamiento del punto de conexión. Los comportamientos de punto de conexión se configuran en <endpoint> elementos; los comportamientos de servicio se configuran en <los elementos del servicio> .

2. Agregue a o cree una <sección endpointBehaviors> y agregue un <elemento de comportamiento> con el nombre que coincida con el valor de atributo del behaviorConfiguration paso 1. Los comportamientos de punto de conexión se agregan para su uso en un elemento cliente <endpoint> mediante un <elemento endpointBehaviors> .

3. Agregue un <elemento callbackDebug> al <elemento de comportamiento> del paso 2 y habilite o deshabilite las distintas propiedades adecuadas para su escenario.

Para obtener un ejemplo concreto, consulte la sección Ejemplo. También puede establecer los valores de este atributo mediante el <elemento callbackDebug> en un archivo de configuración de aplicación cliente.