ServiceDebugBehavior 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
啟用 Windows Communication Foundation (WCF) 服務的偵錯和說明資訊功能。
public ref class ServiceDebugBehavior : System::ServiceModel::Description::IServiceBehaviorpublic class ServiceDebugBehavior : System.ServiceModel.Description.IServiceBehaviortype ServiceDebugBehavior = class
interface IServiceBehaviorPublic Class ServiceDebugBehavior
Implements IServiceBehavior- 繼承
-
ServiceDebugBehavior
- 實作
範例
下列程式碼範例示範如何使用組態檔來啟用 HTML 說明頁功能，並將 SOAP 錯誤內部的例外狀況資訊傳回至用戶端，以供偵錯之用 (除了啟用中繼資料支援)。 這個組態檔會示範下列基本步驟來加入 ServiceDebugBehavior 功能的支援：
因為類型 ServiceDebugBehavior 是實作 System.ServiceModel.Description.IServiceBehavior ，< 所以表示服務類型的服務 >專案具有 的行為組態識別碼
behaviorConfiguration="metadataAndDebug"。因為類型是實作 System.ServiceModel.Description.IServiceBehavior ，< 所以行為 > 專案會新增至< serviceBehaviors >區段。 ServiceDebugBehavior 設定
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>
備註
從組態檔使用 ServiceDebugBehavior 屬性或以程式設計的方式讓 Managed 例外狀況資訊的流量進入用戶端以便偵錯，以及發行可讓使用者在 Web 瀏覽器中瀏覽服務的 HTML 資訊檔案。
將 IncludeExceptionDetailInFaults 屬性設定為 true ，以指示 WCF 將 SOAP 錯誤中的 Managed 例外狀況資訊傳回用戶端以進行偵錯。
警告
將 Managed 例外狀況資訊傳回用戶端可能導致安全性風險，因為例外狀況詳細資料會公開未授權的用戶端可使用的內部服務實作相關資訊。 此外，雖然也能以程式設計方式設定 ServiceDebugBehavior 屬性，不過在部署時很容易會忘記停用 IncludeExceptionDetailInFaults。
由於牽涉到安全性議題，我們強烈建議您：
使用應用程式的組態檔將 IncludeExceptionDetailInFaults 屬性的值設定為
true。您只能在受控制的偵錯狀況下這樣做。
如需與 Managed 例外狀況資訊相關的安全性問題詳細資訊，請參閱 在合約和服務中指定及處理錯誤。
HttpHelpPageEnabled 和 HttpsHelpPageEnabled 屬性會在使用 HTML 瀏覽器檢視服務時，指示服務要發行 HTML 說明檔案。
HttpHelpPageUrl 和 HttpsHelpPageUrl 屬性會控制所檢視的 HTML 說明頁的位置。
如果要使用組態檔啟用或停用其中一項 ServiceDebugBehavior 功能：
behaviorConfiguration將 屬性新增至< WCF 服務的服務 >元素。 端點行為是在端點 > 元素上 <設定;服務元素上的< 服務 >行為。將 新增至或建立< serviceBehaviors >區段，並將行為 > 專案新增 <至，其名稱符合
behaviorConfiguration步驟 1 的屬性值。 端點行為是使用< endpointBehaviors 元素來設定;服務行為是使用 serviceBehaviors >> 元素來設定。 << 將 serviceDebug >元素新增至步驟 2的行為專案， <>並啟用或停用適合您案例的各種屬性。
如需特定範例，請參閱＜範例＞一節。
建構函式
| ServiceDebugBehavior() |
初始化 ServiceDebugBehavior 類別的新執行個體。 |
屬性
| HttpHelpPageBinding |
取得或設定繫結定義的高層級存取權。 |
| HttpHelpPageEnabled |
取得或設定值，控制 Windows Communication Foundation (WCF) 是否在由 HttpHelpPageUrl 屬性控制的位址發佈 HTML 說明頁。 |
| HttpHelpPageUrl |
取得或設定 HTML 說明檔的發行位置。 |
| HttpsHelpPageBinding |
取得或設定繫結定義的高層級存取權。 |
| HttpsHelpPageEnabled |
取得或設定值，指定 Windows Communication Foundation (WCF) 是否會在由 HttpsHelpPageUrl 屬性所控制的位址，透過 HTTPS 傳回 HTML 說明檔。 |
| HttpsHelpPageUrl |
取得或設定發行 HTML 檔案以使用 HTTPS 進行擷取的位置。 |
| IncludeExceptionDetailInFaults |
取得或設定值，指定是否要在傳回至用戶端以進行偵錯的 SOAP 錯誤詳細資料中包含 Managed 例外狀況資訊。 |
方法
| Equals(Object) |
判斷指定的物件是否等於目前的物件。 (繼承來源 Object) |
| GetHashCode() |
做為預設雜湊函式。 (繼承來源 Object) |
| GetType() |
取得目前執行個體的 Type。 (繼承來源 Object) |
| MemberwiseClone() |
建立目前 Object 的淺層複製。 (繼承來源 Object) |
| ToString() |
傳回代表目前物件的字串。 (繼承來源 Object) |
