“ASP.NET 配置设置”对话框 ->“自定义错误”选项卡

更新:2007 年 11 月

在 ASP.NET 网页或组件中发生错误时,ASP.NET 将引发错误代码。错误可以包括以下类型:

  • 编译时错误。

  • 分析器错误(格式不正确的 ASP.NET 元素)。

  • 配置错误。

  • 运行时错误。

    ms186194.alert_note(zh-cn,VS.90).gif说明:

    用于 ASP.NET 的 MMC 管理单元可与 IIS 6.0 及更早版本一起使用。IIS 7.0 管理工具中包含 ASP.NET MMC 工具的功能。有关更多信息,请参见 ASP.NET 和 IIS 配置

默认情况下,ASP.NET 动态生成错误页,其中包含错误说明、发生错误的页面的名称,以及堆栈跟踪。如果启用了调试模式,则动态生成的页面还包括出现错误的源代码的摘要。通过定义自定义错误,可以指定在发生错误时 Web 应用程序的响应方式。

ms186194.alert_note(zh-cn,VS.90).gif说明:

有关调试模式的详细信息,请参见“ASP.NET 配置设置”对话框的“应用程序”选项卡

显示“ASP.NET 配置设置”对话框的“自定义错误”选项卡

  1. 在 Microsoft Windows 中,打开“管理工具”,然后单击“Internet 信息服务 (IIS) 管理器”。

    出现 IIS 管理器。

  2. 在“Internet 信息服务”下,展开“服务器名(本地计算机)”,展开“网站”,右击 Websitename 或“默认网站”,然后单击“属性”。

    出现“网站属性”对话框。

  3. 单击“ASP.NET”选项卡,然后单击“编辑配置”。

    将出现“ASP.NET 配置设置”对话框。

  4. 单击“自定义错误”选项卡。

任务

使用“自定义错误”选项卡可以完成以下任务:

  • 指定在 Web 应用程序中的任何地方发生 ASP.NET 错误时显示的默认错误页。

  • 将特定的 HTTP 错误代码映射到相应的错误页。

    ms186194.alert_note(zh-cn,VS.90).gif说明:

    映射只对 ASP.NET 得到通知的错误有效。例如,默认情况下,发生 HTTP 404 错误(找不到页面)时不通知 ASP.NET。如果想让 ASP.NET 接收这些错误,可以将网站属性设置为将 HTTP 错误映射到 .aspx 页。

  • 指定是将自定义错误页显示给所有用户,还是不显示给任何用户,还是显示给远程用户(非管理用户)。

用户界面元素

  • 自定义错误模式
    单击一个指定如何显示自定义错误的模式,如下所示:

    • 开   

      始终显示自定义错误页。使用此设置可以在开发 Web 应用程序的过程中查看错误。

    • 关   

      不显示自定义错误页。而是在发生错误时产生动态生成的 ASP.NET 错误页。

    • 仅限远程   

      只对不是源自本地 Web 服务器的请求重定向错误。使用此模式,可以在服务器上操作时查看 ASP.NET 错误,而向 Web 应用程序用户显示自定义错误。

  • 默认重定向 URL
    键入在响应 Web 应用程序中的任何地方的未处理错误时显示的页面的名称(.aspx 或 .htm)。

  • 继承的自定义错误
    列出从在层次结构中位于更高级别的配置文件继承的自定义错误页。通过添加想要重写的状态代码的本地自定义错误,可以重写继承的错误设置。

  • 本地自定义错误
    专门列出当前网站的错误页。

  • 添加
    单击可打开“编辑/添加自定义错误处理程序”对话框,在该对话框中可以指定当 ASP.NET 检测到错误时要显示的 HTTP 错误代码和页面。

    ms186194.alert_note(zh-cn,VS.90).gif说明:

    映射只对 ASP.NET 得到通知的错误有效。例如,默认情况下,发生 HTTP 404 错误(找不到页面)时不通知 ASP.NET。如果想让 ASP.NET 接收这些错误,可以将网站属性设置为将 HTTP 错误映射到 .aspx 页。

    必须提供 HTTP 错误代码和它要映射到的页面的 URL。所引用的页不必在当前网站中。

    ms186194.alert_note(zh-cn,VS.90).gif说明:

    IIS 管理器不验证所输入的 URL。

  • 编辑
    单击可打开“编辑/添加自定义错误处理程序”对话框,在该对话框中可以更改在“本地自定义错误”下面选择的页面的名称或错误代码。

  • 移除
    单击它可以删除错误页面映射。

请参见

任务

如何:以编程方式访问 ASP.NET 配置设置

概念

ASP.NET 配置概述

参考

“ASP.NET 配置设置”对话框 ->“身份验证”选项卡

“ASP.NET 配置设置”对话框 ->“授权”选项卡

“ASP.NET 配置设置”对话框的“位置”选项卡

connectionStrings 元素(ASP.NET 设置架构)

appSettings 元素(常规设置架构)