<customErrors> 元素
本主题介绍一项传统技术，保留该技术是为了向后兼容现有的应用程序，不建议对新的开发使用该技术。现在应该使用 Windows Communication Foundation (WCF) 来开发分布式应用程序。
指示此应用程序域中的服务器信道是向本地或远程调用方返回经过筛选的异常信息，还是返回完整的异常信息。此元素可能出现在应用程序配置文件或计算机配置文件中。运行于 Microsoft Windows 98 或更高版本上的 .NET Framework 1.1 版或更高版本中支持此元素。
Schema Hierarchy
<configuration>
<system.runtime.remoting> 元素
<customErrors> 元素
语法
<customErrors
mode="Off|On|RemoteOnly"
/>
特性和元素
以下几节描述了特性、子元素和父元素。
特性
| 特性 | 说明 |
|---|---|
mode |
必选的特性。 指示此应用程序域中的服务器信道是向本地或远程调用方返回经过筛选的异常信息，还是返回完整的异常信息。默认值为 RemoteOnly，该值只将完整的异常信息（包括堆栈跟踪信息）返回给作为服务器的同一计算机上的调用方。 |
子元素
无。
父元素
| 元素 | 说明 |
|---|---|
configuration |
公共语言运行时和 .NET Framework 应用程序所使用的每个配置文件中的根元素。 |
system.runtime.remoting |
包含有关远程对象和信道的信息。 |
备注
完整的异常信息包括确切的服务器异常信息和服务器堆栈跟踪信息。筛选后的信息包括标准的远程异常信息，但不包括服务器堆栈跟踪信息。
下表描述了三个服务器通道属性值，这些值指定收到异常信息的调用方及其收到的信息类型。
| 值 | 说明 |
|---|---|
Off |
所有调用方均收到完整的异常信息。 |
On |
所有调用方均收到筛选后的异常信息。 |
RemoteOnly |
本地调用方收到完整的异常信息，远程调用方收到筛选后的异常信息。 |
示例
以下配置文件示例指示 .NET Framework 远程处理系统代表客户端应用程序域注册一个服务器通道，以便客户端域能够传递将用作回调的委托。如果指定 <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