customErrors 項目 (ASP.NET 設定結構描述)

  • 發行項

提供有關 ASP.NET 應用程式的自訂錯誤訊息的資訊。 customErrors 項目可以在應用程式檔案階層架構中的任何層級中定義。

<customErrors defaultRedirect="url"
              mode="On|Off|RemoteOnly">
     <error. . ./>
</customErrors>

屬性和項目

下列章節會說明屬性、子項目和父項目。

屬性

屬性

描述

defaultRedirect

選擇性屬性。

指定發生錯誤時，要將瀏覽器導向至的預設 URL。 若是沒有指定這個屬性，就會顯示泛型錯誤。

此 URL 可以是絕對 (例如，www.contoso.com/ErrorPage.htm) 或相對的。 相對的 URL (例如 /ErrorPage.htm) 是相對於指定此屬性之 URL 的 Web.config 檔案，而非相對於發生錯誤的 Web 網頁。 以波狀浮號 (~) 起始的 URL (例如 ~/ErrorPage.htm)，表示指定的 URL 是相對於應用程式的根路徑。

mode

必要屬性。

指定是否啟用、停用，或是只對遠端用戶端顯示自訂錯誤。

這個屬性可以是下列其中一個值。

值描述
On 指定啟用自訂錯誤。若未指定 defaultRedirect 屬性，使用者便會看到泛型錯誤。自訂錯誤會顯示在遠端用戶端和本端主機上。
Off 指定停用自訂錯誤。詳細的 ASP.NET 錯誤會顯示在遠端用戶端和本端主機上。
RemoteOnly 指定只對遠端用戶端顯示自訂錯誤，且對本端主機顯示 ASP.NET 錯誤。此為預設值。

預設值為 RemoteOnly。

redirectMode

選擇性屬性。

指定值，這個值會決定當自訂錯誤頁面顯示時要如何處理原始要求的 URL。

這個屬性可以是下列其中一個值。

值描述
ResponseRedirect 指定導向瀏覽器的 URL 必須不同於原始的 Web 要求 URL。
ResponseRewrite 指定導向瀏覽器的 URL 必須是原始的 Web 要求 URL。

子項目

項目

描述

error

選擇性項目。

指定特定之 HTTP 狀態碼的自訂錯誤網頁。

錯誤標記可出現多次。 每次出現都定義一個自訂錯誤條件。

父項目

項目

描述

configuration

指定 Common Language Runtime 和 .NET Framework 應用程式所使用之每個組態檔中的根項目 (Root Element)。

system.web

指定組態檔中 ASP.NET 組態設定的根項目 (Root Element)，並包含會設定 ASP.NET Web 應用程式以及控制這些應用程式之行為的組態項目。

備註

預設組態

在 .NET Framework 1.0 和 1.1 版中，下列預設 customErrors 項目是設定在 Machine.config 檔案中。

<customErrors mode="RemoteOnly" />

範例

下列組態範例示範如何指定用於 ASP.NET 應用程式的錯誤處理網頁。

<configuration>
  <system.web>
    <customErrors defaultRedirect="GenericError.htm"
                  mode="RemoteOnly">
      <error statusCode="500"
             redirect="InternalError.htm"/>
    </customErrors>
  </system.web>
</configuration>

項目資訊

組態區段處理常式

System.Web.Configuration.CustomErrorsSection

組態成員

SystemWebSectionGroup.CustomErrors

System.Web.Configuration.CustomErrorsMode

可設定的位置

Machine.config

根層次的 Web.config

應用程式層級的 Web.config

虛擬或實體目錄層級的 Web.config

需求

Microsoft Internet Information Services (IIS) 5.0、5.1 或 6.0 版

.NET Framework 1.0、1.1 或 2.0 版

Microsoft Visual Studio 2003 或 Visual Studio 2005

請參閱

工作

How to: Lock ASP.NET Configuration Settings

參考

system.web 項目 (ASP.NET 設定結構描述)

configuration 項目 (一般設定結構描述)

customErrors 的 error 項目 (ASP.NET 設定結構描述)

System.Configuration

System.Web.Configuration

概念

ASP.NET Configuration Overview

ASP.NET Server Controls and Browser Capabilities

Securing Configuration

Configuration Inheritance

其他資源

ASP.NET Configuration Files

ASP.NET 組態設定

一般組態設定 (ASP.NET)

ASP.NET Configuration API