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

Статья
08/11/2011

Предоставляет сведения о настраиваемых сообщениях об ошибках для приложения 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-адресом веб-запроса.

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

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

См. также

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

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

Атрибуты

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

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

Заметки

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

Пример

Сведения об элементе

См. также

Задачи

Ссылки

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

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

Дополнительные ресурсы