ServiceDebugElement 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
代表一個設定元素，指定 Windows 通訊基金會（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 程式化，即可啟用管理異常資訊流向用戶端以便除錯，並發布 HTML 資訊檔案，供網頁瀏覽器瀏覽服務的使用者使用。
注意事項
將受管理異常資訊回傳給服務可能構成安全風險。 這是因為例外細節會揭露內部客戶端實作的資訊，這些資訊可能會被未經授權的服務使用。
HttpHelpPageEnabled與HttpsHelpPageEnabled屬性指示服務在使用 HTML 瀏覽器查看服務時發布 HTML 說明檔案。
HttpHelpPageUrl和 HttpsHelpPageUrl 屬性控制被瀏覽的 HTML 說明頁面的位置。
要啟用或停用使用設定檔的某項 ServiceDebugElement 功能，您必須：
為你的 WCF 服務在
behaviorConfiguration<屬性。 （端點行為在元素上設定;服務行為在<endpoint>配置<。）新增或建立一個 <serviceBehaviors> 區塊，並在該區塊中加入<一個名稱與第 1 步屬性值相符的行為>元素。
behaviorConfiguration（端點行為是透過 <endpointBehaviors> 元素配置;服務行為則是透過 <serviceBehaviors> 元素配置。在第 2 步的行為<元素中加入 serviceDebug 元素>，並啟用或停用適合你情境的各種屬性。<>
具體例子請參見範例章節。
建構函式
| 名稱 | Description |
|---|---|
| ServiceDebugElement() |
初始化 ServiceDebugElement 類別的新執行個體。 |
