CallbackDebugBehavior.IncludeExceptionDetailInFaults Propiedad

Definición

Espacio de nombres:

System.ServiceModel.Description

Ensamblados:

System.ServiceModel.dll, System.ServiceModel.Primitives.dll

Paquete:

System.ServiceModel.Primitives v10.0.652802

Source:

CallbackDebugBehavior.cs

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 del cliente administrado en los errores soap con fines de depuración de servicios en comunicación dúplex; de lo contrario, false. El valor predeterminado 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 sobre excepciones gestionadas desde un objeto de devolución de llamada del cliente en los 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

Establezca la IncludeExceptionDetailInFaults propiedad true en desde un archivo de configuración de aplicación o mediante programación para habilitar el flujo de información de excepción administrada en un objeto de devolución de llamada de cliente al servicio con fines de depuración.

Precaución

Devolver información de excepciones administradas a los servicios puede ser un riesgo de seguridad porque los detalles de la excepción exponen información sobre la implementación de cliente interna que podrían usar los servicios no autorizados. Además, aunque las CallbackDebugBehavior propiedades también se pueden establecer mediante programación, puede ser fácil olvidarse de deshabilitar al implementar IncludeExceptionDetailInFaults .

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

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

• Solo lo hace en escenarios de depuración controlados.

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

Para habilitar o deshabilitar una característica de CallbackDebugBehavior mediante un archivo de configuración

1. Agregue un behaviorConfiguration atributo al elemento de punto de conexión> de cliente< para la aplicación cliente WCF. El CallbackDebugBehavior comportamiento es un comportamiento de 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 de servicio> .

2. Agregue o cree una <sección endpointBehaviors> y agregue un <elemento de comportamiento> con el nombre que coincida con el valor del atributo del behaviorConfiguration paso 1. Los comportamientos de los puntos de conexión se agregan para su uso en un elemento de punto de conexión> de cliente< 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 específico, vea la sección Ejemplo. También puede establecer los valores de este atributo mediante el <elemento callbackDebug> en un archivo de configuración de la aplicación cliente.