CustomError Klasa

Definicja

Namespace:

System.Web.Configuration

Montaż:

System.Web.dll

Konfiguruje sekcję CustomError w celu mapowania kodu błędu ASP.NET na stronę niestandardową. Klasa ta nie może być dziedziczona.

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

Dziedziczenie

Object

ConfigurationElement

CustomError

Przykłady

W tym przykładzie pokazano, jak deklaratywnie określić wartości dla kilku atrybutów customErrors sekcji, do których można również uzyskać dostęp jako elementy członkowskie CustomError klasy.

Poniższy przykład pliku konfiguracji pokazuje, jak deklaratywnie określić wartości dla customErrors sekcji.

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

W poniższym przykładzie kodu pokazano, jak używać CustomError klasy.

// 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

Uwagi

Klasa CustomError zapewnia sposób programowego uzyskiwania dostępu i modyfikowania error sekcji pliku konfiguracji. Ten typ jest częścią grupy zawierającej CustomErrorCollection, CustomErrorsModei CustomErrorsSection.

Uwaga

Podczas definiowania błędu niestandardowego ASP.NET przypisuje do niego standardowy błąd zwykle wystawiony przez podstawową usługę, taką jak usługi IIS. Jeśli na przykład zdefiniujesz niestandardowy błąd dla kodu stanu 404, ASP.NET wyda go w dowolnym momencie, gdy odwołujesz się do nie istniejącej strony aspx. Błędy niestandardowe są wystawiane tylko dla tych elementów obsługiwanych przez ASP.NET. Jeśli na przykład odwołujesz się do nie istniejącej strony .htm, usługi IIS wystawiają standardowy błąd 404.

Konstruktorów

Nazwa	Opis
CustomError(Int32, String)	Inicjuje nowe wystąpienie klasy CustomError.

Właściwości

Nazwa	Opis
CurrentConfiguration	Pobiera odwołanie do wystąpienia najwyższego poziomu Configuration , które reprezentuje hierarchię konfiguracji, do którego należy bieżące ConfigurationElement wystąpienie. (Dziedziczone od ConfigurationElement)
ElementInformation	ElementInformation Pobiera obiekt, który zawiera niezstosowalne informacje i funkcje ConfigurationElement obiektu. (Dziedziczone od ConfigurationElement)
ElementProperty	ConfigurationElementProperty Pobiera obiekt reprezentujący ConfigurationElement sam obiekt. (Dziedziczone od ConfigurationElement)
EvaluationContext	ContextInformation Pobiera obiekt dla ConfigurationElement obiektu. (Dziedziczone od ConfigurationElement)
HasContext	Pobiera wartość wskazującą, czy CurrentConfiguration właściwość to null. (Dziedziczone od ConfigurationElement)
Item[ConfigurationProperty]	Pobiera lub ustawia właściwość lub atrybut tego elementu konfiguracji. (Dziedziczone od ConfigurationElement)
Item[String]	Pobiera lub ustawia właściwość, atrybut lub element podrzędny tego elementu konfiguracji. (Dziedziczone od ConfigurationElement)
LockAllAttributesExcept	Pobiera kolekcję zablokowanych atrybutów. (Dziedziczone od ConfigurationElement)
LockAllElementsExcept	Pobiera kolekcję zablokowanych elementów. (Dziedziczone od ConfigurationElement)
LockAttributes	Pobiera kolekcję zablokowanych atrybutów. (Dziedziczone od ConfigurationElement)
LockElements	Pobiera kolekcję zablokowanych elementów. (Dziedziczone od ConfigurationElement)
LockItem	Pobiera lub ustawia wartość wskazującą, czy element jest zablokowany. (Dziedziczone od ConfigurationElement)
Properties	Pobiera kolekcję właściwości. (Dziedziczone od ConfigurationElement)
Redirect	Pobiera lub ustawia adres URL przekierowania.
StatusCode	Pobiera lub ustawia kod stanu błędu HTTP.

Metody

Nazwa	Opis
DeserializeElement(XmlReader, Boolean)	Odczytuje kod XML z pliku konfiguracji. (Dziedziczone od ConfigurationElement)
Equals(Object)	Porównuje błędy CustomError .
GetHashCode()	Pobiera kod skrótu CustomError obiektu.
GetTransformedAssemblyString(String)	Zwraca przekształconą wersję określonej nazwy zestawu. (Dziedziczone od ConfigurationElement)
GetTransformedTypeString(String)	Zwraca przekształconą wersję określonej nazwy typu. (Dziedziczone od ConfigurationElement)
GetType()	Type Pobiera bieżące wystąpienie. (Dziedziczone od Object)
Init()	ConfigurationElement Ustawia obiekt na stan początkowy. (Dziedziczone od ConfigurationElement)
InitializeDefault()	Służy do inicjowania domyślnego zestawu wartości dla ConfigurationElement obiektu. (Dziedziczone od ConfigurationElement)
IsModified()	Wskazuje, czy ten element konfiguracji został zmodyfikowany od czasu ostatniego zapisania lub załadowania, gdy został zaimplementowany w klasie pochodnej. (Dziedziczone od ConfigurationElement)
IsReadOnly()	Pobiera wartość wskazującą, czy ConfigurationElement obiekt jest tylko do odczytu. (Dziedziczone od ConfigurationElement)
ListErrors(IList)	Dodaje błędy nieprawidłowej właściwości w tym ConfigurationElement obiekcie i we wszystkich podelementach do przekazanej listy. (Dziedziczone od ConfigurationElement)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Dziedziczone od Object)
OnDeserializeUnrecognizedAttribute(String, String)	Pobiera wartość wskazującą, czy podczas deserializacji napotkano nieznany atrybut. (Dziedziczone od ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)	Pobiera wartość wskazującą, czy podczas deserializacji napotkano nieznany element. (Dziedziczone od ConfigurationElement)
OnRequiredPropertyNotFound(String)	Zgłasza wyjątek, gdy nie znaleziono wymaganej właściwości. (Dziedziczone od ConfigurationElement)
PostDeserialize()	Wywoływana po deserializacji. (Dziedziczone od ConfigurationElement)
PreSerialize(XmlWriter)	Wywoływane przed serializacji. (Dziedziczone od ConfigurationElement)
Reset(ConfigurationElement)	Resetuje stan ConfigurationElement wewnętrzny obiektu, w tym blokady i kolekcje właściwości. (Dziedziczone od ConfigurationElement)
ResetModified()	Resetuje wartość IsModified() metody w false przypadku implementacji w klasie pochodnej. (Dziedziczone od ConfigurationElement)
SerializeElement(XmlWriter, Boolean)	Zapisuje zawartość tego elementu konfiguracji do pliku konfiguracji po zaimplementowaniu w klasie pochodnej. (Dziedziczone od ConfigurationElement)
SerializeToXmlElement(XmlWriter, String)	Zapisuje zewnętrzne tagi tego elementu konfiguracji do pliku konfiguracji po zaimplementowaniu w klasie pochodnej. (Dziedziczone od ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)	Ustawia właściwość na określoną wartość. (Dziedziczone od ConfigurationElement)
SetReadOnly()	IsReadOnly() Ustawia właściwość obiektu ConfigurationElement i wszystkich podelementów. (Dziedziczone od ConfigurationElement)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Dziedziczone od Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)	Modyfikuje obiekt, ConfigurationElement aby usunąć wszystkie wartości, które nie powinny być zapisywane. (Dziedziczone od ConfigurationElement)

Zobacz także

• CustomErrorsSection
• CustomErrorCollection