close

http://msdn.microsoft.com/zh-tw/library/h0hfz6fc(VS.80).aspx

 

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

 

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

<configuration> 項目
  system.web 項目 (ASP.NET 設定結構描述)
    <customErrors> 項目
<customErrors defaultRedirect="url"
              mode="On|Off|RemoteOnly">
     <error. . ./>
</customErrors>
 屬性和項目

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

屬性

屬性 描述

defaultRedirect

選擇性屬性。

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

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

mode

必要的屬性。

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

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

值 描述

On

指定啟用自訂錯誤。若未指定 defaultRedirect 屬性，使用者便會看到泛型錯誤。

Off

指定停用自訂錯誤。如此可以顯示標準的詳細錯誤。

RemoteOnly

指定只對遠端用戶端顯示自訂錯誤，且對本機主機顯示 ASP.NET 錯誤。這是預設值。

預設值為 RemoteOnly。

子項目

項目 描述

error

選擇性項目。

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

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

父項目

項目 描述

configuration

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

system.web

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

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

 預設的組態

在 .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

組態成員

System.Web.Configuration.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
arrow
arrow
    全站熱搜
    創作者介紹
    創作者 meltdown 的頭像
    meltdown

    meltdown

    meltdown 發表在 痞客邦 留言(0) 人氣()

    E-mail轉寄