ServiceDebugBehavior.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 Windows Communication Foundation (WCF) 디버깅을 위해; 클라이언트에 대 한 SOAP 오류에서 관리 되는 예외 정보를 반환 하는 경우 그렇지 않으면 false합니다. 기본값은 false입니다.

예제

다음 코드 예제에서는 구성 파일을 사용하여 HTML 도움말 페이지 기능을 사용하도록 설정하고 디버깅 목적으로 SOAP 오류 내부의 예외 정보를 클라이언트에 반환하는 방법을 보여 줍니다. 이 구성 파일에서는 ServiceDebugBehavior 기능을 지원하는 다음과 같은 기본 단계를 보여 줍니다.

• 형식이 구현이므로 서비스 형식을 나타내는 서비스 요소에는 동작 구성 식별자가 behaviorConfiguration="metadataAndDebug"있습니다.>< System.ServiceModel.Description.IServiceBehavior ServiceDebugBehavior

• 형식이 ServiceDebugBehavior 구현<이므로 동작> 요소가 serviceBehaviors> 섹션에< 추가됩니다.System.ServiceModel.Description.IServiceBehavior name 동작> 요소의< 특성을 서비스> 요소 특성의< behaviorConfiguration 식별자 값으로 설정합니다. 이 경우 값은 metadataAndDebug입니다.

• 다양한 특성이 원하는 구성으로 설정된 serviceDebug> 요소를 추가합니다.< 이 경우 httpHelpPageEnabled 및 includeExceptionDetailInFaults 특성 값을 true로 설정합니다.

<configuration>
  <system.serviceModel>
    <services>
      <!-- 
        Step 1. Add a behaviorConfiguration attribute
        in the <service> element.
      -->
      <service 
        name="Microsoft.WCF.Documentation.SampleService"
        behaviorConfiguration="metadataAndDebug">
        <host>
          <baseAddresses>
            <add baseAddress="http://localhost:8080/SampleService" />
          </baseAddresses>
        </host>
        <endpoint
          address=""
          binding="wsHttpBinding"
          contract="Microsoft.WCF.Documentation.ISampleService"
        />
        <endpoint
           address="mex"
           binding="mexHttpBinding"
           contract="IMetadataExchange"
        />
      </service>
    </services>
    <behaviors>
      <serviceBehaviors>
        <!-- 
          Step 2. Inside a <serviceBehaviors> section, add 
          a name attribute in the <behaviors> element that 
          matches the behaviorConfiguration attribute in the
          <service> element above.
        -->
        <behavior name="metadataAndDebug">
          <serviceMetadata 
            httpGetEnabled="true" 
            httpGetUrl=""
          />
          <!-- 
            Step 3. Add a <serviceDebug> element and 
            modify the various attributes that suit your 
            scenario.
          -->
          <serviceDebug 
            httpHelpPageEnabled="true" 
            includeExceptionDetailInFaults="true"
          />
        </behavior>
      </serviceBehaviors>
    </behaviors>
  </system.serviceModel>
</configuration>

설명

설정 된 IncludeExceptionDetailInFaults 속성을 true 예외 정보를 클라이언트에 SOAP 오류 관리 되는 반환 하도록 WCF에 지시 하려면 손쉬운 디버깅을 위해에 합니다.

주의

관리되는 예외 정보를 클라이언트에 반환하면 예외 정보가 내부 서비스 구현 정보를 노출하여 권한이 없는 클라이언트에서 사용할 수 있으므로 보안상 위험할 수 있습니다. 또한 프로그래밍 방식으로 ServiceDebugBehavior 속성을 설정할 수도 있지만 배포 시 IncludeExceptionDetailInFaults 비활성화를 잊기 쉬울 수 있습니다.

보안 문제와 관련이 있으므로 다음 작업을 수행하는 것이 좋습니다.

• 애플리케이션 구성 파일을 사용하여 IncludeExceptionDetailInFaults 속성 값을 true로 설정합니다.

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

자세한 내용은 지정 및 계약 및 서비스에서 오류 처리합니다.