CallbackDebugBehavior.IncludeExceptionDetailInFaults 속성

정의

네임스페이스:

System.ServiceModel.Description

어셈블리:

System.ServiceModel.dll

클라이언트 콜백 개체가 관리되는 예외 정보를 SOAP 오류의 형태로 서비스에 반환하는지 여부를 제어하는 값을 가져오거나 설정합니다.

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

속성 값

Boolean

true WCF 관리 되는 클라이언트 콜백 예외 정보를 SOAP 오류 형태로 반환 서비스 디버깅을 위해 이중 통신; 그렇지 않으면 false합니다. 기본값은 false입니다.

예제

다음 코드 예제에서는 클라이언트를 관리 되는 예외 정보에서에서 반환할 클라이언트 콜백 개체가 SOAP 메시지의 WCF에 지시 하는 구성 파일을 보여 줍니다.

  <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로 설정합니다.

• 이 작업은 제어된 디버깅 시나리오에서만 수행하도록 합니다.

관리 되는 예외 정보와 관련 된 보안 문제에 대 한 자세한 내용은 참조 하세요. 지정 및 계약 및 서비스에서 오류 처리합니다.

구성 파일을 사용하여 CallbackDebugBehavior의 기능을 사용하거나 사용하지 않도록 설정하려면

1. behaviorConfiguration WCF 클라이언트 애플리케이션의 클라이언트 <endpoint> 요소에 특성을 추가합니다. CallbackDebugBehavior 동작은 엔드포인트 동작입니다. 엔드포인트 동작은 요소에 <endpoint> 대해 구성됩니다. 서비스 동작은 서비스> 요소에서< 구성됩니다.

2. endpointBehaviors> 섹션에 추가하거나 만들고< 1단계의 특성 값과 일치하는 behaviorConfiguration 이름으로 동작> 요소를 추가<합니다. 엔드포인트 동작은 endpointBehaviors> 요소를 사용하여 클라이언트 요소에서< 사용하기 위해 추가됩니다.<endpoint>

3. 2단계의 동작> 요소에< callbackDebug> 요소를 추가하고 시나리오에 적합한 다양한 속성을 사용하거나 사용하지 않도록 설정합니다.<

구체적인 예를 보려면 예제 부분을 참조하십시오. 클라이언트 애플리케이션 구성 파일에서 callbackDebug> 요소를 사용하여< 이 특성의 값을 설정할 수도 있습니다.