CallbackDebugBehavior 类

定义

命名空间:

System.ServiceModel.Description

程序集:

System.ServiceModel.Primitives.dll

包:

System.ServiceModel.Primitives v8.0.0

Source:

CallbackDebugBehavior.cs

为 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

继承

Object

CallbackDebugBehavior

实现

IEndpointBehavior

示例

下面的代码示例演示一个客户端配置文件，该文件指示 WCF 从 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>

注解

从应用程序配置文件中或以编程方式将 IncludeExceptionDetailInFaults 属性设置为 true，则可以使客户端回调对象中的托管异常信息回流到该服务，以便进行调试。

注意

将托管异常信息返回到服务可能存在安全风险，因为异常详细信息会公开有关内部客户端实现的信息，而未经授权的服务可能会使用这些信息。 此外，虽然 CallbackDebugBehavior 属性也可以通过编程方式进行设置，但在部署时容易忘记禁用 IncludeExceptionDetailInFaults。

由于涉及到一些安全问题，因此强烈建议您：

• 使用应用程序配置文件将 IncludeExceptionDetailInFaults 属性的值设置为 true。

• 仅在受控调试方案中才这样做。

有关与托管异常信息相关的安全问题的详细信息，请参阅 在协定和服务中指定和处理错误。

还可以通过使用 <客户端应用程序配置文件中的 callbackDebug> 元素来设置此属性的值。

构造函数

CallbackDebugBehavior(Boolean)

初始化 CallbackDebugBehavior 类的新实例。

属性

IncludeExceptionDetailInFaults

获取或设置一个值，该值控制客户端回调对象是否将 SOAP 错误中的托管异常信息返回到服务。

方法

Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetType()	获取当前实例的 Type。 (继承自 Object)
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
ToString()	返回表示当前对象的字符串。 (继承自 Object)

显式接口实现

IEndpointBehavior.AddBindingParameters(ServiceEndpoint, BindingParameterCollection)	实现 AddBindingParameters(ServiceEndpoint, BindingParameterCollection) 方法以支持该行为。
IEndpointBehavior.ApplyClientBehavior(ServiceEndpoint, ClientRuntime)	实现 ApplyClientBehavior(ServiceEndpoint, ClientRuntime) 以支持该行为。
IEndpointBehavior.ApplyDispatchBehavior(ServiceEndpoint, EndpointDispatcher)	实现 ApplyDispatchBehavior(ServiceEndpoint, EndpointDispatcher) 以支持该行为。
IEndpointBehavior.Validate(ServiceEndpoint)	实现 Validate(ServiceEndpoint) 以支持该行为。