CustomError Класс

Определение

Пространство имен:

System.Web.Configuration

Сборка:

System.Web.dll

Настраивает раздел CustomError для сопоставления кода ошибки ASP.NET с пользовательской страницей. Этот класс не наследуется.

public ref class CustomError sealed : System::Configuration::ConfigurationElement

public sealed class CustomError : System.Configuration.ConfigurationElement

type CustomError = class
    inherit ConfigurationElement

Public NotInheritable Class CustomError
Inherits ConfigurationElement

Наследование

Object

ConfigurationElement

CustomError

Примеры

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

В следующем примере файла конфигурации показано, как указывать значения декларативно для customErrors раздела.

<customErrors mode="RemoteOnly"
  defaultRedirect="customerror.htm">
    <error statusCode="404" redirect="customerror404.htm"/>
</customErrors>

В следующем примере кода показано, как использовать CustomError класс.

// Get the Web application configuration.
Configuration configuration =
    WebConfigurationManager.OpenWebConfiguration(
    "/aspnetTest");

// Get the section.
CustomErrorsSection customErrors =
    (CustomErrorsSection)configuration.GetSection(
  "system.web/customErrors");

// Get the collection.
CustomErrorCollection customErrorsCollection =
    customErrors.Errors;

' Get the Web application configuration.
  Dim configuration _
  As System.Configuration.Configuration = _
  WebConfigurationManager.OpenWebConfiguration( _
  "/aspnetTest")

' Get the section.
  Dim customErrors As CustomErrorsSection = _
   CType(configuration.GetSection( _
   "system.web/customErrors"), CustomErrorsSection)

' Get the collection.
  Dim customErrorsCollection _
  As CustomErrorCollection = _
  customErrors.Errors

Комментарии

Класс CustomError предоставляет способ программного доступа и изменения error раздела файла конфигурации. Этот тип является частью группы, включающей CustomErrorCollectionCustomErrorsMode, и CustomErrorsSection.

Note

При определении пользовательской ошибки ASP.NET назначает ему стандартную ошибку, обычно выданную базовой службой, например IIS. Например, если вы определяете пользовательскую ошибку для кода состояния 404, ASP.NET будет выдавать его в любое время, когда вы ссылаетесь на несуществующую страницу .aspx. Пользовательские ошибки выдаются только для этих элементов, обрабатываемых ASP.NET. Например, если вы ссылаетесь на несуществующую страницу .htm, iis выдает стандартную ошибку 404.

Конструкторы

Имя	Описание
CustomError(Int32, String)	Инициализирует новый экземпляр класса CustomError.

Свойства

Имя	Описание
CurrentConfiguration	Возвращает ссылку на экземпляр верхнего уровня Configuration , представляющий иерархию конфигурации, к которой принадлежит текущий ConfigurationElement экземпляр. (Унаследовано от ConfigurationElement)
ElementInformation	ElementInformation Возвращает объект, содержащий не настраиваемую информацию и функциональные возможности ConfigurationElement объекта. (Унаследовано от ConfigurationElement)
ElementProperty	ConfigurationElementProperty Возвращает объект, представляющий ConfigurationElement сам объект. (Унаследовано от ConfigurationElement)
EvaluationContext	Возвращает объект ContextInformation для объекта ConfigurationElement. (Унаследовано от ConfigurationElement)
HasContext	Возвращает значение, указывающее, является CurrentConfigurationли null свойство. (Унаследовано от ConfigurationElement)
Item[ConfigurationProperty]	Возвращает или задает свойство или атрибут этого элемента конфигурации. (Унаследовано от ConfigurationElement)
Item[String]	Возвращает или задает свойство, атрибут или дочерний элемент этого элемента конфигурации. (Унаследовано от ConfigurationElement)
LockAllAttributesExcept	Возвращает коллекцию заблокированных атрибутов. (Унаследовано от ConfigurationElement)
LockAllElementsExcept	Возвращает коллекцию заблокированных элементов. (Унаследовано от ConfigurationElement)
LockAttributes	Возвращает коллекцию заблокированных атрибутов. (Унаследовано от ConfigurationElement)
LockElements	Возвращает коллекцию заблокированных элементов. (Унаследовано от ConfigurationElement)
LockItem	Возвращает или задает значение, указывающее, заблокирован ли элемент. (Унаследовано от ConfigurationElement)
Properties	Возвращает коллекцию свойств. (Унаследовано от ConfigurationElement)
Redirect	Возвращает или задает URL-адрес перенаправления.
StatusCode	Возвращает или задает код состояния ошибки HTTP.

Методы

Имя	Описание
DeserializeElement(XmlReader, Boolean)	Считывает XML из файла конфигурации. (Унаследовано от ConfigurationElement)
Equals(Object)	Сравнивает CustomError ошибки.
GetHashCode()	CustomError Возвращает хэш-код объекта.
GetTransformedAssemblyString(String)	Возвращает преобразованную версию указанного имени сборки. (Унаследовано от ConfigurationElement)
GetTransformedTypeString(String)	Возвращает преобразованную версию указанного имени типа. (Унаследовано от ConfigurationElement)
GetType()	Возвращает Type текущего экземпляра. (Унаследовано от Object)
Init()	Задает объект исходному ConfigurationElement состоянию. (Унаследовано от ConfigurationElement)
InitializeDefault()	Используется для инициализации набора значений по умолчанию для ConfigurationElement объекта. (Унаследовано от ConfigurationElement)
IsModified()	Указывает, был ли изменен этот элемент конфигурации после последнего сохранения или загрузки при реализации в производном классе. (Унаследовано от ConfigurationElement)
IsReadOnly()	Возвращает значение, указывающее, доступен ли ConfigurationElement объект только для чтения. (Унаследовано от ConfigurationElement)
ListErrors(IList)	Добавляет ошибки недопустимого свойства в этом ConfigurationElement объекте и во все подэлементы в переданный список. (Унаследовано от ConfigurationElement)
MemberwiseClone()	Создает неглубокую копию текущей Object. (Унаследовано от Object)
OnDeserializeUnrecognizedAttribute(String, String)	Возвращает значение, указывающее, обнаружен ли неизвестный атрибут во время десериализации. (Унаследовано от ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)	Возвращает значение, указывающее, обнаружен ли неизвестный элемент во время десериализации. (Унаследовано от ConfigurationElement)
OnRequiredPropertyNotFound(String)	Создает исключение, если обязательное свойство не найдено. (Унаследовано от ConfigurationElement)
PostDeserialize()	Вызывается после десериализации. (Унаследовано от ConfigurationElement)
PreSerialize(XmlWriter)	Вызывается перед сериализацией. (Унаследовано от ConfigurationElement)
Reset(ConfigurationElement)	Сбрасывает внутреннее состояние ConfigurationElement объекта, включая блокировки и коллекции свойств. (Унаследовано от ConfigurationElement)
ResetModified()	Сбрасывает значение IsModified() метода false на момент реализации в производном классе. (Унаследовано от ConfigurationElement)
SerializeElement(XmlWriter, Boolean)	Записывает содержимое этого элемента конфигурации в файл конфигурации при реализации в производном классе. (Унаследовано от ConfigurationElement)
SerializeToXmlElement(XmlWriter, String)	Записывает внешние теги этого элемента конфигурации в файл конфигурации при реализации в производном классе. (Унаследовано от ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)	Задает свойству указанное значение. (Унаследовано от ConfigurationElement)
SetReadOnly()	IsReadOnly() Задает свойство для ConfigurationElement объекта и всех вложенных элементов. (Унаследовано от ConfigurationElement)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)	Изменяет объект для удаления всех значений ConfigurationElement , которые не должны быть сохранены. (Унаследовано от ConfigurationElement)

См. также раздел

• CustomErrorsSection
• CustomErrorCollection