<customErrors> 項目

提供有關 ASP.NET 應用程式的自訂錯誤訊息的資訊。

<configuration>
   <system.web>
      <customErrors>

<customErrorsdefaultRedirect="url"
              mode="On|Off|RemoteOnly">
   <error statusCode="statuscode"
          redirect="url"/>
</customErrors>

必要屬性

屬性	選項	說明
Mode		指定啟用、停用自訂錯誤或只對遠端用戶端顯示。
	On	指定啟用自訂錯誤。若未指定 defaultRedirect，使用者將看到泛用錯誤。
	Off	指定停用自訂錯誤。如此可顯示詳細的錯誤。
	RemoteOnly	指定只對遠端用戶端顯示自訂錯誤，且對本機主機顯示 ASP.NET 錯誤。這是預設值。

選擇性屬性

屬性	說明
defaultRedirect	指定發生錯誤時要將瀏覽器導向的預設 URL。若未指定 defaultRedirect，則顯示泛用錯誤。URL 可能是絕對的 (例如，https://www.contoso.com/ErrorPage.htm)，也可能是相對的。相對的 URL (例如 /ErrorPage.htm) 是相對於指定 defaultRedirect URL 的 Web.config 檔案，而不是相對於發生錯誤的 Web 網頁。以波狀浮號 (~) 起始的 URL (例如 ~/ErrorPage.htm) 表示指定的 URL 是相對於應用程式的根路徑。

子標記

子標記	說明
<error>	錯誤子標記可出現多次。每次出現都定義一個自訂錯誤條件。

備註

<customErrors> 項目不適用於發生在 XML Web Service 中的錯誤。

範例

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

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

需求

包含於：<system.web>

**Web 平台：**IIS 5.0、IIS 5.1、IIS 6.0

**組態檔：**Machine.config, Web.config

**組態區段處理常式：**System.Web.Configuration.CustomErrorsConfigHandler

請參閱

ASP.NET 組態 | ASP.NET 設定結構描述