ServiceDebugElement 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
表示一个配置元素，该元素指定 Windows Communication Foundation (WCF) 服务的调试和帮助信息功能。 此类不能被继承。
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，则可以将托管异常信息流到客户端以便进行调试，还可以向在 Web 浏览器中浏览该服务的用户发布 HTML 信息文件。
注意
向服务返回托管异常信息可能具有安全风险。 这是因为，异常详细信息公开了有关内部客户端实现的信息，这些信息可能被未经授权的服务使用。
当使用 HTML 浏览器查看服务时，HttpHelpPageEnabled 和 HttpsHelpPageEnabled 属性指示服务发布 HTML 帮助文件。
HttpHelpPageUrl 和 HttpsHelpPageUrl 属性控制所查看的 HTML 帮助页的位置。
若要使用配置文件启用或禁用其中一个 ServiceDebugElement 功能，必须：
将
behaviorConfiguration特性添加到 <WCF 服务的 service> 元素。 (终结点行为是在元素上<endpoint>配置的;服务元素上的 <服务> 行为。)将 添加到或创建 <serviceBehaviors> 节，并在其中添加一个<行为>元素，其名称与步骤 1 中的
behaviorConfiguration属性值匹配。 (终结点行为是使用 <endpointBehaviors> 元素配置的;服务行为是使用 <serviceBehaviors> 元素配置的。将 <serviceDebug> 元素添加到步骤 2 中的 <behavior> 元素，并启用或禁用适合你的方案的各种属性。
有关具体示例的信息，请参见“示例”部分。
构造函数
| ServiceDebugElement() |
初始化 ServiceDebugElement 类的新实例。 |
