RemotingConfiguration.CustomErrorsEnabled(Boolean) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
顯示此應用域中的伺服器通道是否回傳經過過濾或完整的異常資訊給本地或遠端呼叫者。
public:
static bool CustomErrorsEnabled(bool isLocalRequest);
public static bool CustomErrorsEnabled(bool isLocalRequest);
static member CustomErrorsEnabled : bool -> bool
Public Shared Function CustomErrorsEnabled (isLocalRequest As Boolean) As Boolean
參數
- isLocalRequest
- Boolean
true 用以指定本地來電者; false 用來指定遠端來電者。
傳回
true若僅回傳經過過濾的例外資訊給本地或遠端呼叫者,依參數isLocalRequestfalse指定;若回傳完整的異常資訊。
備註
完整的例外資訊包括精確的伺服器例外及伺服器堆疊追蹤。 過濾資訊包含標準的遠端存取例外,但沒有伺服器堆疊追蹤。
此CustomErrorsEnabled方法反映應用程式設定檔元素屬性中指定的mode<customErrors>設定。
下表顯示三個伺服器通道屬性值,分別指定哪些呼叫者接收例外資訊及接收何種類型的資訊。
| 價值 | 說明 |
|---|---|
off |
所有來電者都會收到完整的例外資訊。 |
on |
所有來電者都會收到經過過濾的例外資訊。 |
remoteOnly |
本地來電者會收到完整的例外資訊;遠端呼叫者會收到經過過濾的異常資訊。 |
下表展示了參數 isLocalRequest 與伺服器通道特性之間的互動。
| 價值 | isLocalRequest | 返回值 | 說明 |
|---|---|---|---|
on |
true |
true |
本地來電者會收到經過過濾的例外資訊。 |
on |
false |
true |
遠端來電者會收到經過過濾的例外資訊。 |
off |
true |
false |
本地來電者會收到完整的例外資訊。 |
off |
false |
false |
遠端呼叫者會收到完整的例外資訊。 |
remoteOnly |
true |
false |
本地來電者會收到完整的例外資訊。 |
remoteOnly |
false |
true |
遠端來電者會收到經過過濾的例外資訊。 |
關於如何使用應用程式設定檔來控制異常資訊回傳給呼叫者的資訊,請參見元素。<customErrors>