Класс CustomErrorsSection

Статья
2023-07-19

Настраивает ASP.NET пользовательских сообщений об ошибках.

Синтаксис

class CustomErrorsSection : ConfigurationSectionWithCollection

Методы

В следующей таблице перечислены методы, предоставляемые классом CustomErrorsSection .

Имя	Описание
Добавление	(Наследуется от ConfigurationSectionWithCollection.)
Очистить	(Является наследником `ConfigurationSectionWithCollection`)
Get	(Является наследником `ConfigurationSectionWithCollection`)
GetAllowDefinition	(Наследуется от ConfigurationSection.)
GetAllowLocation	(Является наследником `ConfigurationSection`)
Удалить	(Является наследником `ConfigurationSectionWithCollection`)
RevertToParent	(Является наследником `ConfigurationSection`)
SetAllowDefinition	(Является наследником `ConfigurationSection`)
SetAllowLocation	(Является наследником `ConfigurationSection`)

Свойства

В следующей таблице перечислены свойства, предоставляемые классом CustomErrorsSection .

Имя	Описание
`CustomErrors`	Массив значений CustomError , указывающих ASP.NET пользовательские ошибки.
`DefaultRedirect`	Обязательное, непустое значение для чтения и записи `string` , содержащее путь по умолчанию к файлу сообщения об ошибке HTTP или URL-адресу сообщения об ошибке. Это значение наследуется свойством `Redirect` вновь созданных объектов CustomError .
`Location`	(Наследуется от `ConfigurationSection`.) Свойство ключа.
`Mode`	Перечисление чтения и записи `sint32` , указывающее, отображаются ли пользовательские страницы ошибок или страницы ошибок по умолчанию локально или удаленно. Возможные значения перечислены далее в разделе Примечания.
`Path`	(Наследуется от `ConfigurationSection`.) Свойство ключа.
`SectionInformation`	(Является наследником `ConfigurationSection`)

используются подклассы ;

Этот класс не содержит подклассов.

Пользовательские ошибки, представленные классом CustomErrorsSection , относятся к ASP.NET и находятся в <system.web> разделе файла Web.config. Каждая из этих ошибок представлена экземпляром класса CustomError .

Пользовательские ошибки, представленные классом HttpErrorsSection , связаны с IIS 7 и находятся в <system.webServer> разделе файла ApplicationHost.config. Каждая из этих ошибок представлена экземпляром класса HttpErrorElement . Интеграция ASP.NET с IIS в IIS 7 сделала это имя необходимым.

В следующей таблице перечислены возможные значения свойства Mode . Значение по умолчанию — 0 (RemoteOnly).

Значение	Ключевое слово	Описание
0	`RemoteOnly`	Для локальных пользователей отображается страница ошибки ASP.NET по умолчанию. Удаленные пользователи получат пользовательскую страницу ошибки, если она определена. Если для полученной ошибки не определена пользовательская страница ошибки, отображается страница ошибки IIS.
1	`On`	Для локальных и удаленных пользователей отображается пользовательская страница ASP.NET пользовательской ошибки.
2	`Off`	Страница ошибки ASP.NET по умолчанию отображается как для локальных, так и для удаленных пользователей.

Пример

В следующем примере свойству DefaultRedirect присваивается значение "CustomError.htm", а свойству Mode — значение On.

' Connect to the WMI WebAdministration namespace.  
Set oWebAdmin = GetObject("winmgmts:root\WebAdministration")  
  
' Get the custom errors section for the default Web site.  
Set oSite = oWebAdmin.Get("Site.Name='Default Web Site'")  
oSite.GetSection "CustomErrorsSection", oSection  
  
' Set the default redirect page to CustomError.htm,  
' and set the Mode property to On.  
oSection.DefaultRedirect = "CustomError.htm"  
oSection.Mode = 1  
oSection.Put_

Иерархия наследования

ConfigurationSection

ConfigurationSectionWithCollection

CustomErrorsSection

Требования

Тип	Описание
клиент	— IIS 7.0 в Windows Vista — IIS 7.5 в Windows 7 — IIS 8.0 в Windows 8 — IIS 10.0 в Windows 10
Сервер	— IIS 7.0 в Windows Server 2008 — IIS 7.5 в Windows Server 2008 R2 — IIS 8.0 в Windows Server 2012 — IIS 8.5 в Windows Server 2012 R2 — IIS 10.0 в Windows Server 2016
Продукт	— IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0
MOF-файл	WebAdministration.mof

См. также:

Класс ConfigurationSectionWithCollection
Класс CustomError
Класс HttpErrorElement
Класс HttpErrorsSection