ServiceDebugElement 클래스

정의

네임스페이스:

System.ServiceModel.Configuration

어셈블리:

System.ServiceModel.dll

WCF(Windows Communication Foundation) 서비스의 디버깅 및 도움말 정보 기능을 지정하는 구성 요소를 나타냅니다. 이 클래스는 상속될 수 없습니다.

public ref class ServiceDebugElement sealed : System::ServiceModel::Configuration::BehaviorExtensionElement

public sealed class ServiceDebugElement : System.ServiceModel.Configuration.BehaviorExtensionElement

type ServiceDebugElement = class
    inherit BehaviorExtensionElement

Public NotInheritable Class ServiceDebugElement
Inherits BehaviorExtensionElement

상속

Object

ConfigurationElement

ServiceModelExtensionElement

BehaviorExtensionElement

ServiceDebugElement

상속

Object

ConfigurationElement

ServiceModelConfigurationElement

ServiceModelExtensionElement

BehaviorExtensionElement

ServiceDebugElement

예제

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

<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로 설정한 경우 관리되는 예외 정보가 디버깅을 위해 클라이언트로 전달되게 하고, 웹 브라우저에서 서비스를 검색하는 사용자를 위해 HTML 정보 파일을 게시할 수 있습니다.

주의

관리되는 예외 정보를 서비스에 반환할 때 보안상 위험이 따를 수 있습니다. 예외 정보가 내부 클라이언트 구현 정보를 공개하여 권한 없는 서비스에서 이를 사용할 수 있기 때문입니다.

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

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

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

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

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

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

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

생성자

ServiceDebugElement()

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

속성

BehaviorType	이 동작 요소의 형식을 가져옵니다.
ConfigurationElementName	이 구성 요소의 이름을 가져옵니다. (다음에서 상속됨 ServiceModelExtensionElement)
CurrentConfiguration	현재 Configuration 인스턴스가 속해 있는 구성 계층 구조를 나타내는 최상위 ConfigurationElement 인스턴스에 대한 참조를 가져옵니다. (다음에서 상속됨 ConfigurationElement)
ElementInformation	ElementInformation 개체의 사용자 지정할 수 없는 정보와 기능을 포함하는 ConfigurationElement 개체를 가져옵니다. (다음에서 상속됨 ConfigurationElement)
ElementProperty	ConfigurationElementProperty 개체 자체를 나타내는 ConfigurationElement 개체를 가져옵니다. (다음에서 상속됨 ConfigurationElement)
EvaluationContext	ContextInformation 개체의 ConfigurationElement 개체를 가져옵니다. (다음에서 상속됨 ConfigurationElement)
HasContext	CurrentConfiguration 속성이 null인지 여부를 나타내는 값을 가져옵니다. (다음에서 상속됨 ConfigurationElement)
HttpHelpPageBinding	HTTP를 사용하여 서비스 도움말 페이지에 액세스할 때 사용할 바인딩을 지정하는 문자열 값을 가져오거나 설정합니다.
HttpHelpPageBindingConfiguration	HttpHelpPageBinding에 지정된 바인딩에 대한 추가 구성 정보를 정의하는 XML 섹션을 가리키는 문자열을 가져오거나 설정합니다.
HttpHelpPageEnabled	WCF(Windows Communication Foundation)가 HttpHelpPageUrl 속성으로 지정된 주소에 HTML 도움말 페이지를 게시할지 여부를 나타내는 값을 가져오거나 설정합니다.
HttpHelpPageUrl	HTML 도움말 파일이 게시되는 위치를 가져오거나 설정합니다.
HttpsHelpPageBinding	HTTPS를 사용하여 서비스 도움말 페이지에 액세스할 때 사용할 바인딩을 지정하는 문자열 값을 가져오거나 설정합니다.
HttpsHelpPageBindingConfiguration	HttpsHelpPageBinding에 지정된 바인딩에 대한 추가 구성 정보를 정의하는 XML 섹션을 가리키는 문자열을 가져오거나 설정합니다.
HttpsHelpPageEnabled	WCF(Windows Communication Foundation)가 HttpsHelpPageUrl 속성으로 지정된 주소에 HTTPS를 통해 HTML 도움말 파일을 반환할지 여부를 제어하는 값을 가져오거나 설정합니다.
HttpsHelpPageUrl	HTTPS를 통해 HTML 도움말 파일이 게시되는 위치를 가져오거나 설정합니다.
IncludeExceptionDetailInFaults	디버깅 목적으로 클라이언트에 반환되는 SOAP 오류 정보에 관리되는 예외 정보를 포함할지 여부를 지정하는 값을 가져오거나 설정합니다.
Item[ConfigurationProperty]	이 구성 요소의 속성이나 특성을 가져오거나 설정합니다. (다음에서 상속됨 ConfigurationElement)
Item[String]	이 구성 요소의 속성, 특성 또는 자식 요소를 가져오거나 설정합니다. (다음에서 상속됨 ConfigurationElement)
LockAllAttributesExcept	잠긴 특성의 컬렉션을 가져옵니다. (다음에서 상속됨 ConfigurationElement)
LockAllElementsExcept	잠긴 요소의 컬렉션을 가져옵니다. (다음에서 상속됨 ConfigurationElement)
LockAttributes	잠긴 특성의 컬렉션을 가져옵니다. (다음에서 상속됨 ConfigurationElement)
LockElements	잠긴 요소의 컬렉션을 가져옵니다. (다음에서 상속됨 ConfigurationElement)
LockItem	요소가 잠겨 있는지 여부를 나타내는 값을 가져오거나 설정합니다. (다음에서 상속됨 ConfigurationElement)
Properties	속성 컬렉션을 가져옵니다. (다음에서 상속됨 ConfigurationElement)

메서드

CopyFrom(ServiceModelExtensionElement)	지정된 구성 요소의 내용을 이 구성 요소에 복사합니다.
CreateBehavior()	현재 구성 설정에 따라 동작 확장을 만듭니다. (다음에서 상속됨 BehaviorExtensionElement)
DeserializeElement(XmlReader, Boolean)	구성 파일에서 XML을 읽습니다. (다음에서 상속됨 ConfigurationElement)
Equals(Object)	현재 ConfigurationElement 인스턴스를 지정된 개체와 비교합니다. (다음에서 상속됨 ConfigurationElement)
GetHashCode()	현재 ConfigurationElement 인스턴스를 나타내는 고유 값을 가져옵니다. (다음에서 상속됨 ConfigurationElement)
GetTransformedAssemblyString(String)	지정된 어셈블리 이름의 변환된 버전을 반환합니다. (다음에서 상속됨 ConfigurationElement)
GetTransformedTypeString(String)	지정된 형식 이름의 변환된 버전을 반환합니다. (다음에서 상속됨 ConfigurationElement)
GetType()	현재 인스턴스의 Type을 가져옵니다. (다음에서 상속됨 Object)
Init()	ConfigurationElement 개체를 초기 상태로 설정합니다. (다음에서 상속됨 ConfigurationElement)
InitializeDefault()	ConfigurationElement 개체 값의 기본 집합을 초기화하는 데 사용됩니다. (다음에서 상속됨 ConfigurationElement)
IsModified()	이 구성 요소가 수정되었는지 여부를 나타내는 값을 가져옵니다. (다음에서 상속됨 ServiceModelExtensionElement)
IsReadOnly()	ConfigurationElement 개체가 읽기 전용인지 여부를 나타내는 값을 가져옵니다. (다음에서 상속됨 ConfigurationElement)
ListErrors(IList)	이 ConfigurationElement 개체와 모든 하위 요소의 잘못된 속성 오류를 전달된 목록에 추가합니다. (다음에서 상속됨 ConfigurationElement)
MemberwiseClone()	현재 Object의 단순 복사본을 만듭니다. (다음에서 상속됨 Object)
OnDeserializeUnrecognizedAttribute(String, String)	역직렬화하는 동안 알 수 없는 특성을 발견했는지 여부를 나타내는 값을 가져옵니다. (다음에서 상속됨 ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)	역직렬화하는 동안 알 수 없는 요소를 발견했는지 여부를 나타내는 값을 가져옵니다. (다음에서 상속됨 ConfigurationElement)
OnRequiredPropertyNotFound(String)	필수 속성이 없으면 예외를 throw합니다. (다음에서 상속됨 ConfigurationElement)
PostDeserialize()	deserialization 후에 호출됩니다. (다음에서 상속됨 ConfigurationElement)
PreSerialize(XmlWriter)	serialization 전에 호출됩니다. (다음에서 상속됨 ConfigurationElement)
Reset(ConfigurationElement)	잠금 및 속성 컬렉션을 비롯하여 이 구성 요소의 내부 상태를 다시 설정합니다. (다음에서 상속됨 ServiceModelExtensionElement)
ResetModified()	파생 클래스에서 구현되는 경우 IsModified() 메서드의 값을 false로 다시 설정합니다. (다음에서 상속됨 ConfigurationElement)
SerializeElement(XmlWriter, Boolean)	이 구성 요소의 내용을 구성 파일에 씁니다. (다음에서 상속됨 ServiceModelExtensionElement)
SerializeToXmlElement(XmlWriter, String)	파생 클래스에서 구현될 때 구성 요소의 외부 태그를 구성 파일에 씁니다. (다음에서 상속됨 ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)	속성을 지정된 값으로 설정합니다. (다음에서 상속됨 ConfigurationElement)
SetPropertyValueIfNotDefaultValue<T>(String, T)	값이 기본값이 아닐 경우 구성 요소의 속성 값을 설정합니다. (다음에서 상속됨 ServiceModelConfigurationElement)
SetReadOnly()	IsReadOnly() 개체와 모든 하위 요소에 대한 ConfigurationElement 속성을 설정합니다. (다음에서 상속됨 ConfigurationElement)
ToString()	현재 개체를 나타내는 문자열을 반환합니다. (다음에서 상속됨 Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)	ConfigurationElement 개체를 수정하여 저장되지 않아야 하는 값을 모두 제거합니다. (다음에서 상속됨 ConfigurationElement)

추가 정보

• <serviceDebug>