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>
項目資訊
組態區段處理常式 |
|
組態成員 |
|
可設定的位置 |
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 |
請參閱
工作
參考
system.web 項目 (ASP.NET 設定結構描述)
customErrors 的 error 項目 (ASP.NET 設定結構描述)