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


Элемент 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 указывается по отношению к файлу Web.config, в котором определен URL-адрес этого атрибута, а не к веб-странице, на которой возникла ошибка. Начинающийся с тильды ("~") URL-адрес (например, ~/ErrorPage.htm) означает, что данный адрес указывается от корневого пути приложения.

mode

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

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

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

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

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

redirectMode

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

Задает значения для способа обработки URL-адреса исходного запроса при отображении пользовательской страницы ошибки.

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

ЗначениеОписание
ResponseRedirect Указывает, что URL-адрес для направления браузера должен отличаться от исходного URL-адреса веб-запроса.
ResponseRewrite Указывает, что URL-адрес для направления браузера должен совпадать с исходным URL-адресом веб-запроса.

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

Элемент

Описание

error

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

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

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

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

Элемент

Описание

configuration

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

system.web

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

Заметки

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

Следующий элемент 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

Ссылки

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

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

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

System.Configuration

System.Web.Configuration

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

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

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

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

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

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

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

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

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

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