Элемент error для элемента customErrors (схема параметров ASP.NET)
Обновлен: Ноябрь 2007
Определяет страницу настраиваемой ошибки для получаемого кода состояния HTTP.
Элемент <configuration>
Элемент system.web (схема параметров ASP.NET)
Элемент customErrors (схема параметров ASP.NET)
Элемент error для элемента customErrors (схема параметров ASP.NET)
<error statusCode="statuscode"
redirect="url"/>
Атрибуты и элементы
В следующих разделах описаны атрибуты, дочерние элементы и родительские элементы.
Атрибуты
Атрибут |
Описание |
|---|---|
statusCode |
Обязательный атрибут. Указывает код состояния HTTP, который вызывает перенаправление на страницу обработки ошибки. |
redirect |
Обязательный атрибут. URL-адрес настраиваемой страницы, отображающей код ошибки. |
Дочерние элементы
Нет.
Родительские элементы
Элемент |
Описание |
|---|---|
configuration |
Задает обязательный корневой элемент любого файла конфигурации, используемого средой CLR и приложениями .NET Framework. |
system.web |
Задает корневой элемент для раздела конфигурации ASP.NET. |
customErrors |
Предоставляет сведения о настраиваемых сообщениях об ошибках для приложения ASP.NET. Определяется на любом уровне в иерархии файла приложения. |
Пример
В следующем примере кода конфигурации указываются страницы обработки ошибок, используемые в приложении ASP.NET.
Настраиваемые ошибки показываются только для тех элементов, которые обрабатываются ASP.NET. Например, при обращении к несуществующей HTML-странице Microsoft IIS выдает стандартную ошибку 404. При обращении к несуществующей ASPX-странице ASP.NET выдает стандартную ошибку 404 только в том случае, если эта ошибка настроена.
<configuration>
<system.web>
<customErrors defaultRedirect="GenericError.htm"
mode="RemoteOnly">
<error statusCode="500"
redirect="InternalError.htm"/>
</customErrors>
</system.web>
</configuration>
Сведения об элементе
Обработчик раздела конфигурации |
|
Элемент конфигурации |
|
Настраиваемые расположения |
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
Ссылки
Элемент customErrors (схема параметров ASP.NET)
Элемент system.web (схема параметров ASP.NET)
Элемент configuration (схема общих параметров)
Другие ресурсы
Параметры конфигурации ASP.NET