ServiceDebugElement 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
WCF(Windows Communication Foundation) 서비스의 디버깅 및 도움말 정보 기능을 지정하는 구성 요소를 나타냅니다. 이 클래스는 상속될 수 없습니다.
public ref class ServiceDebugElement sealed : System::ServiceModel::Configuration::BehaviorExtensionElementpublic sealed class ServiceDebugElement : System.ServiceModel.Configuration.BehaviorExtensionElementtype ServiceDebugElement = class
inherit BehaviorExtensionElementPublic NotInheritable Class ServiceDebugElement
Inherits 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 기능 중 하나를 사용하거나 사용하지 않도록 설정하려면 다음을 수행해야 합니다.
behaviorConfigurationWCF 서비스의 서비스> 요소에 특성을< 추가합니다. (엔드포인트 동작은 요소에<endpoint>대해 구성됩니다. 서비스 요소의 <서비스> 동작).serviceBehaviors> 섹션을 추가하거나 만들고< 1단계의 특성 값과 일치하는
behaviorConfiguration이름으로 동작> 요소를 추가<합니다. 엔드포인트 동작은 endpointBehaviors> 요소를 사용하여< 구성됩니다. 서비스 동작은 serviceBehaviors> 요소를 사용하여< 구성됩니다.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 속성이 |
| 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) |