Поделиться через

Элемент customErrors (схема параметров ASP.NET)

  • Статья

Обновлен: Ноябрь 2007

Предоставляет сведения о настраиваемых сообщениях об ошибках для приложения ASP.NET. Элемент customErrors можно определить на любом уровне в иерархии файлов приложения.

Элемент <configuration>
  Элемент system.web (схема параметров ASP.NET)
    <customErrors> Element

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

Атрибуты и элементы

В следующих разделах описываются атрибуты, дочерние и родительские элементы.

Атрибуты

Атрибут

Описание

defaultRedirect

Необязательный атрибут.

Указывает URL-адрес по умолчанию, на который будет перенаправлен обозреватель при возникновении ошибки. Если значение этого атрибута не указано, то вместо этого отображается универсальное сообщение об ошибке.

URL-адрес может быть абсолютным (например, www.contoso.com/ErrorPage.htm) или относительным. Относительный URL-адрес, например /ErrorPage.htm указывается по отношению к файлу Web.config, в котором определен URL-адрес этого атрибута, а не к веб-странице, на которой возникла ошибка. Начинающийся с тильды ("~") URL-адрес (например, ~/ErrorPage.htm) означает, что данный адрес указывается от корневого пути приложения.

mode

Обязательный атрибут.

Определяет, будут ли настраиваемые ошибки разрешены, запрещены или показаны только удаленным клиентам.

Этот атрибут может принимать одно из следующих значений.

ЗначениеОписание
On Указывает, что настраиваемые ошибки разрешены. Если атрибут не указан defaultRedirect, то пользователи видят универсальное сообщение об ошибке. Настраиваемые ошибки отображаются только для удаленных клиентов и на локальном узле.
Off Указывает, что настраиваемые ошибки запрещены. Подробные сведения об ошибках ASP.NET отображаются только для удаленных клиентов и на локальном узле.
RemoteOnly Указывает, что настраиваемые ошибки отображаются только для удаленных клиентов, а ошибки ASP.NET отображаются на локальном узле. Это значение по умолчанию.

По умолчанию используется значение RemoteOnly.

Дочерние элементы

Элемент

Описание

error

Необязательный элемент.

Определяет страницу настраиваемой ошибки для получаемого кода состояния HTTP.

Этот описывающий ошибку тег может встречаться несколько раз. Каждый раз, когда встречается этот тег, он описывает одно условие настраиваемой ошибки.

Родительские элементы

Элемент

Описание

configuration

Задает корневой элемент любого файла конфигурации, используемого средой CLR и приложениями .NET Framework.

system.web

Определяет корневой элемент для параметров конфигурации ASP.NET в файле конфигурации и содержит элементы конфигурации, предназначенные для настройки веб-приложений ASP.NET и управления их работой.

Заметки

Элемент <customErrors> не применяется к ошибкам, которые возникают в веб-службах XML.

Параметры по умолчанию

Следующий элемент customErrors по умолчанию задается в файле Machine.config для платформы .NET Framework версий 1.0 и 1.1.

<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 IIS версии 5.0, 5.1 или 6.0

Платформа .NET Framework версии 1.0, 1.1 или 2.0

Microsoft Visual Studio 2003 или Visual Studio 2005

См. также

Задачи

Пошаговое руководство. Отключение параметров конфигурации ASP.NET

Основные понятия

Общие сведения о конфигурационном ASP.NET

Серверные веб-элементы управления ASP.NET и возможности обозревателей

Настройка обеспечения безопасности ASP.NET

Сценарии конфигурации ASP.NET

Ссылки

Элемент system.web (схема параметров ASP.NET)

Элемент configuration (схема общих параметров)

Элемент error для элемента customErrors (схема параметров ASP.NET)

System.Configuration

System.Web.Configuration

Другие ресурсы

Файлы конфигурации ASP.NET

Параметры конфигурации ASP.NET

Общие параметры конфигурации (ASP.NET)

Конфигурационный интерфейс API ASP.NET