<customErrors> 項目
本主題專門說明一項為了在現有應用程式中提供回溯相容性而保留的舊有技術，不建議用於新的開發工作。分散式應用程式應使用 Windows Communication Foundation (WCF) 進行開發。
指示這個應用程式定義域中的伺服器通道是否會將篩選過或完整的例外狀況資訊，傳回至本機或遠端的呼叫端。這個項目可能出現在應用程式組態檔或電腦組態檔中。Microsoft Windows 98 或更新版上的 .NET Framework 1.1 版或更新版本中支援此項目。
Schema Hierarchy
<configuration>
<system.runtime.remoting> 項目
<customErrors> 項目
語法
<customErrors
mode="Off|On|RemoteOnly"
/>
屬性和元素
下列章節會說明屬性 (Attribute)、子項目和父項目。
屬性
| 屬性 | 說明 |
|---|---|
mode |
必要屬性。 指示這個應用程式定義域中的伺服器通道是否會將篩選過或完整的例外狀況資訊，傳回至本機或遠端的呼叫端。預設為 RemoteOnly，只會將完整的例外狀況資訊 (包括堆疊追蹤)，傳回給和伺服器相同電腦上的呼叫端。 |
項目子系
無。
父項目
| 項目 | 說明 |
|---|---|
configuration |
Common Language Runtime 和 .NET Framework 應用程式所使用之每個組態檔中的根項目。 |
system.runtime.remoting |
包含有關遠端物件和通道的資訊。 |
備註
完整的例外狀況資訊包括確切的伺服器例外狀況和伺服器堆疊追蹤。篩選過的資訊包括標準的遠端例外狀況，但不包括伺服器堆疊追蹤。
下表說明三種伺服器通道屬性值，這些值會指定哪個呼叫端接收例外狀況資訊以及它們所接收的資訊類型。
| 值 | 說明 |
|---|---|
Off |
所有呼叫端都接收完整的例外狀況資訊。 |
On |
所有呼叫端都接收篩選過的例外狀況資訊。 |
RemoteOnly |
本機呼叫端接收完整的例外狀況資訊；遠端呼叫端接收篩選過的例外狀況資訊。 |
範例
下列的組態檔範例告訴 .NET Framework 遠端處理系統代表用戶端應用程式定義域來註冊伺服器通道，使用戶端定義域可以傳遞委派 (Delegate) 當做回呼 (Callback)。如果在回呼時用戶端上發生例外狀況，則指定 <customErrors mode="Off"/> 會使伺服器接收完整的例外狀況資訊，包括堆疊追蹤。
<configuration>
<system.runtime.remoting>
<application>
<client url="http://computername:8080">
<activated type="ClientActivatedType, RemoteType"/>
</client>
<channels>
<channel ref="http" port="0">
<serverProviders>
<formatter ref="soap" typeFilterLevel="Full"/>
<formatter ref="binary" typeFilterLevel="Full"/>
</serverProviders>
</channel>
</channels>
</application>
<customErrors mode="Off"/>
</system.runtime.remoting>
</configuration>
另請參閱
參考
遠端設定結構描述
System.Runtime.Remoting.RemotingConfiguration.CustomErrorsEnabled(System.Boolean)
建置日期：2010-02-13