RemotingConfiguration.CustomErrorsEnabled 方法
指示该应用程序域中的服务器信道是将筛选过的异常信息返回给本地调用方或远程调用方,还是将完整的异常信息返回给本地调用方或远程调用方。
**命名空间:**System.Runtime.Remoting
**程序集:**mscorlib(在 mscorlib.dll 中)
语法
声明
Public Shared Function CustomErrorsEnabled ( _
isLocalRequest As Boolean _
) As Boolean
用法
Dim isLocalRequest As Boolean
Dim returnValue As Boolean
returnValue = RemotingConfiguration.CustomErrorsEnabled(isLocalRequest)
public static bool CustomErrorsEnabled (
bool isLocalRequest
)
public:
static bool CustomErrorsEnabled (
bool isLocalRequest
)
public static boolean CustomErrorsEnabled (
boolean isLocalRequest
)
public static function CustomErrorsEnabled (
isLocalRequest : boolean
) : boolean
参数
- isLocalRequest
true 用于指定本地调用方,false 用于指定远程调用方。
返回值
如果只将筛选过的异常信息返回给本地调用方或远程调用方(具体返回给哪些调用方由 isLocalRequest 参数指定),则为 true;如果返回完整的异常信息,则为 false。
备注
完整的异常信息包括精确的服务器异常信息和服务器堆栈跟踪信息。而筛选过的信息只包含标准的远程处理异常信息,不包含服务器堆栈跟踪信息。
CustomErrorsEnabled 反映了应用程序配置文件的 <customErrors> 元素的 mode 属性中指定的配置设置。有关配置选项的更多信息,请参见 远程应用程序的配置。
下表描述了服务器信道属性的三个值,它们指定了哪些调用方将接收异常信息,以及这些调用方将接收什么类型的信息。
值 |
说明 |
---|---|
off |
所有调用方均接收完整的异常信息。 |
on |
所有调用方均接收筛选过的异常信息。 |
remoteOnly |
本地调用方接收完整的异常信息,而远程调用方则接收筛选过的异常信息。 |
下表描述了 isLocalRequest 参数和服务器信道属性之间的相互关系。
值 |
isLocalRequest |
返回值 |
说明 |
---|---|---|---|
on |
true |
true |
本地调用方接收筛选过的异常信息。 |
on |
false |
true |
远程调用方接收筛选过的异常信息。 |
off |
true |
false |
本地调用方接收完整的异常信息。 |
off |
false |
false |
远程调用方接收完整的异常信息。 |
remoteOnly |
true |
false |
本地调用方接收完整的异常信息。 |
remoteOnly |
false |
true |
远程调用方接收筛选过的异常信息。 |
有关如何使用应用程序配置文件来控制向调用方返回异常信息的信息,请参见 <customErrors> 元素。
平台
Windows 98、Windows 2000 SP4、Windows Millennium Edition、Windows Server 2003、Windows XP Media Center Edition、Windows XP Professional x64 Edition、Windows XP SP2、Windows XP Starter Edition
.NET Framework 并不是对每个平台的所有版本都提供支持。有关受支持版本的列表,请参见系统要求。
版本信息
.NET Framework
受以下版本支持:2.0、1.1
请参见
参考
RemotingConfiguration 类
RemotingConfiguration 成员
System.Runtime.Remoting 命名空间