ServiceDebugBehavior 클래스

정의

네임스페이스:

System.ServiceModel.Description

어셈블리:

System.ServiceModel.dll

WCF(Windows Communication Foundation) 서비스에 대한 디버깅 및 도움말 정보 기능을 지정합니다.

public ref class ServiceDebugBehavior : System::ServiceModel::Description::IServiceBehavior

public class ServiceDebugBehavior : System.ServiceModel.Description.IServiceBehavior

type ServiceDebugBehavior = class
    interface IServiceBehavior

Public Class ServiceDebugBehavior
Implements IServiceBehavior

상속

Object

ServiceDebugBehavior

구현

IServiceBehavior

예제

다음 코드 예제에서는 구성 파일을 사용하여 메타데이터 지원 및 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>

설명

디버깅을 위해 클라이언트에 예외 정보를 전달하고 웹 브라우저에서 서비스를 검색하는 사용자를 위해 HTML 정보 파일을 게시하려면 프로그래밍 방식 또는 구성 파일에서 ServiceDebugBehavior 속성을 사용합니다.

설정 된 IncludeExceptionDetailInFaults 속성을 true 관리 되는 반환 하도록 WCF에 지시 예외 정보를 SOAP 오류의 클라이언트로 디버깅 목적으로 합니다.

주의

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

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

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

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

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

HttpHelpPageEnabled 및 HttpsHelpPageEnabled 속성은 HTML 브라우저를 사용하여 서비스를 볼 때 해당 서비스에 HTML 도움말 파일을 게시하도록 지시합니다.

HttpHelpPageUrl 및 HttpsHelpPageUrl 속성은 표시되는 HTML 도움말 페이지의 위치를 제어합니다.

구성 파일을 사용하여 ServiceDebugBehavior 기능 중 하나를 사용하거나 사용하지 않도록 설정하려면 다음을 수행합니다.

1. behaviorConfiguration WCF 서비스의 서비스> 요소에 특성을< 추가합니다. 엔드포인트 동작은 요소, <endpoint> 서비스> 요소의 서비스 동작에< 대해 구성됩니다.

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

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

구체적인 예를 보려면 예제 부분을 참조하십시오.

생성자

ServiceDebugBehavior()

ServiceDebugBehavior 클래스의 새 인스턴스를 초기화합니다.

속성

HttpHelpPageBinding	바인딩 정의에 대한 높은 수준의 액세스를 가져오거나 설정합니다.
HttpHelpPageEnabled	WCF(Windows Communication Foundation)가 HttpHelpPageUrl 속성으로 제어된 주소에 HTML 도움말 페이지를 게시할지 여부를 제어하는 값을 가져오거나 설정합니다.
HttpHelpPageUrl	HTML 도움말 파일이 게시되는 위치를 가져오거나 설정합니다.
HttpsHelpPageBinding	바인딩 정의에 대한 높은 수준의 액세스를 가져오거나 설정합니다.
HttpsHelpPageEnabled	WCF(Windows Communication Foundation)가 HttpsHelpPageUrl 속성으로 제어된 주소에 HTTPS를 통해 HTML 도움말 파일을 반환할지 여부를 제어하는 값을 가져오거나 설정합니다.
HttpsHelpPageUrl	HTTPS를 통해 HTML 파일이 게시되는 위치를 가져오거나 설정합니다.
IncludeExceptionDetailInFaults	디버깅 목적으로 클라이언트에 반환되는 SOAP 오류 정보에 관리되는 예외 정보를 포함할지 여부를 지정하는 값을 가져오거나 설정합니다.

메서드

Equals(Object)	지정된 개체가 현재 개체와 같은지 확인합니다. (다음에서 상속됨 Object)
GetHashCode()	기본 해시 함수로 작동합니다. (다음에서 상속됨 Object)
GetType()	현재 인스턴스의 Type을 가져옵니다. (다음에서 상속됨 Object)
MemberwiseClone()	현재 Object의 단순 복사본을 만듭니다. (다음에서 상속됨 Object)
ToString()	현재 개체를 나타내는 문자열을 반환합니다. (다음에서 상속됨 Object)

명시적 인터페이스 구현

IServiceBehavior.AddBindingParameters(ServiceDescription, ServiceHostBase, Collection<ServiceEndpoint>, BindingParameterCollection)	AddBindingParameters(ServiceDescription, ServiceHostBase, Collection<ServiceEndpoint>, BindingParameterCollection) 메서드를 구현하여 동작을 지원합니다.
IServiceBehavior.ApplyDispatchBehavior(ServiceDescription, ServiceHostBase)	ApplyDispatchBehavior(ServiceDescription, ServiceHostBase) 메서드를 구현하여 동작을 지원합니다.
IServiceBehavior.Validate(ServiceDescription, ServiceHostBase)	Validate(ServiceDescription, ServiceHostBase) 메서드를 구현하여 동작을 지원합니다.