CustomErrorsSection Klasa

Definicja

Przestrzeń nazw:

System.Web.Configuration

Zestaw:

System.Web.dll

Konfiguruje błędy niestandardowe ASP.NET. Klasa ta nie może być dziedziczona.

public ref class CustomErrorsSection sealed : System::Configuration::ConfigurationSection

public sealed class CustomErrorsSection : System.Configuration.ConfigurationSection

type CustomErrorsSection = class
    inherit ConfigurationSection

Public NotInheritable Class CustomErrorsSection
Inherits ConfigurationSection

Dziedziczenie

Object

ConfigurationElement

ConfigurationSection

CustomErrorsSection

Przykłady

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

W poniższym przykładzie pliku konfiguracji pokazano, 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 pokazano, jak używać CustomErrorsSection klasy .

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

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

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

      ' Get the Web application configuration.
        Dim configuration _
        As System.Configuration.Configuration = _
WebConfigurationManager.OpenWebConfiguration( _
        "/aspnetTest")
      
      ' Get the section.
        Dim customErrorsSection _
        As CustomErrorsSection = _
        CType(configuration.GetSection( _
  "system.web/customErrors"), _
  CustomErrorsSection)
      
      ' Get the collection
        Dim customErrorsCollection _
        As CustomErrorCollection = customErrorsSection.Errors

Uwagi

Klasa CustomErrorsSection umożliwia programowy dostęp i modyfikowanie customErrors sekcji pliku konfiguracji. Ten typ jest częścią grupy, która zawiera CustomErrorCollectiontypy , CustomErrorsModei CustomError .

Note

Element CustomErrorsSection może odczytywać i zapisywać informacje z i do powiązanej sekcji pliku konfiguracji zgodnie z właściwością AllowDefinition sekcji, której wartość to Everywhere.

Konstruktory

Nazwa	Opis
CustomErrorsSection()	Inicjuje nowe wystąpienie klasy CustomErrorsSection przy użyciu ustawień domyślnych.

Właściwości

Nazwa	Opis
AllowNestedErrors	Pobiera lub ustawia wartość wskazującą, czy ASP.NET powinien wyświetlać ogólny komunikat o błędzie, gdy nie można wyświetlić niestandardowej strony błędu.
CurrentConfiguration	Pobiera odwołanie do wystąpienia najwyższego poziomu Configuration, które reprezentuje hierarchię konfiguracji, do którego należy bieżące wystąpienie ConfigurationElement. (Odziedziczone po ConfigurationElement)
DefaultRedirect	Pobiera lub ustawia domyślny adres URL przekierowania.
ElementInformation	Pobiera obiekt ElementInformation zawierający informacje i funkcje obiektu ConfigurationElement, które nie można dostosowywać. (Odziedziczone po ConfigurationElement)
ElementProperty	Pobiera obiekt ConfigurationElementProperty reprezentujący sam obiekt ConfigurationElement. (Odziedziczone po ConfigurationElement)
Errors	Pobiera kolekcję CustomError obiektów.
EvaluationContext	Pobiera obiekt ContextInformation dla obiektu ConfigurationElement. (Odziedziczone po ConfigurationElement)
HasContext	Pobiera wartość wskazującą, czy właściwość CurrentConfiguration jest null. (Odziedziczone po ConfigurationElement)
Item[ConfigurationProperty]	Pobiera lub ustawia właściwość lub atrybut tego elementu konfiguracji. (Odziedziczone po ConfigurationElement)
Item[String]	Pobiera lub ustawia właściwość, atrybut lub element podrzędny tego elementu konfiguracji. (Odziedziczone po ConfigurationElement)
LockAllAttributesExcept	Pobiera kolekcję zablokowanych atrybutów. (Odziedziczone po ConfigurationElement)
LockAllElementsExcept	Pobiera kolekcję zablokowanych elementów. (Odziedziczone po ConfigurationElement)
LockAttributes	Pobiera kolekcję zablokowanych atrybutów. (Odziedziczone po ConfigurationElement)
LockElements	Pobiera kolekcję zablokowanych elementów. (Odziedziczone po ConfigurationElement)
LockItem	Pobiera lub ustawia wartość wskazującą, czy element jest zablokowany. (Odziedziczone po ConfigurationElement)
Mode	Pobiera lub ustawia modalność wyświetlania błędu.
Properties	Pobiera kolekcję właściwości. (Odziedziczone po ConfigurationElement)
RedirectMode	Pobiera lub ustawia wartość wskazującą, czy adres URL żądania powinien zostać zmieniony, gdy użytkownik zostanie przekierowany do niestandardowej strony błędu.
SectionInformation	SectionInformation Pobiera obiekt, który zawiera informacje i funkcje ConfigurationSection obiektu, które nie można dostosowywać. (Odziedziczone po ConfigurationSection)

Metody

Nazwa	Opis
DeserializeElement(XmlReader, Boolean)	Odczytuje kod XML z pliku konfiguracji. (Odziedziczone po ConfigurationElement)
DeserializeSection(XmlReader)	Odczytuje kod XML z pliku konfiguracji. (Odziedziczone po ConfigurationSection)
Equals(Object)	Porównuje bieżące ConfigurationElement wystąpienie z określonym obiektem. (Odziedziczone po ConfigurationElement)
GetHashCode()	Pobiera unikatową wartość reprezentującą bieżące ConfigurationElement wystąpienie. (Odziedziczone po ConfigurationElement)
GetRuntimeObject()	Zwraca obiekt niestandardowy podczas zastępowania w klasie pochodnej. (Odziedziczone po ConfigurationSection)
GetTransformedAssemblyString(String)	Zwraca przekształconą wersję określonej nazwy zestawu. (Odziedziczone po ConfigurationElement)
GetTransformedTypeString(String)	Zwraca przekształconą wersję określonej nazwy typu. (Odziedziczone po ConfigurationElement)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
Init()	Ustawia obiekt ConfigurationElement na stan początkowy. (Odziedziczone po ConfigurationElement)
InitializeDefault()	Służy do inicjowania domyślnego zestawu wartości dla obiektu ConfigurationElement. (Odziedziczone po ConfigurationElement)
IsModified()	Wskazuje, czy ten element konfiguracji został zmodyfikowany od czasu ostatniego zapisania, czy załadowany podczas implementacji w klasie pochodnej. (Odziedziczone po ConfigurationSection)
IsReadOnly()	Pobiera wartość wskazującą, czy ConfigurationElement obiekt jest tylko do odczytu. (Odziedziczone po ConfigurationElement)
ListErrors(IList)	Dodaje błędy nieprawidłowej właściwości w tym obiekcie ConfigurationElement i we wszystkich elementach podrzędnych do przekazanej listy. (Odziedziczone po ConfigurationElement)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
OnDeserializeUnrecognizedAttribute(String, String)	Pobiera wartość wskazującą, czy podczas deserializacji napotkano nieznany atrybut. (Odziedziczone po ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)	Pobiera wartość wskazującą, czy podczas deserializacji napotkano nieznany element. (Odziedziczone po ConfigurationElement)
OnRequiredPropertyNotFound(String)	Zgłasza wyjątek, gdy nie można odnaleźć wymaganej właściwości. (Odziedziczone po ConfigurationElement)
PostDeserialize()	Wywoływana po deserializacji. (Odziedziczone po ConfigurationElement)
PreSerialize(XmlWriter)	Wywoływana przed serializacji. (Odziedziczone po ConfigurationElement)
Reset(ConfigurationElement)	Resetuje stan ConfigurationElement wewnętrzny obiektu, w tym blokady i kolekcje właściwości. (Odziedziczone po ConfigurationElement)
ResetModified()	Resetuje wartość IsModified() metody w false przypadku implementacji w klasie pochodnej. (Odziedziczone po ConfigurationSection)
SerializeElement(XmlWriter, Boolean)	Zapisuje zawartość tego elementu konfiguracji w pliku konfiguracji po zaimplementowaniu w klasie pochodnej. (Odziedziczone po ConfigurationElement)
SerializeSection(ConfigurationElement, String, ConfigurationSaveMode)	Tworzy ciąg XML zawierający niezaergowany widok ConfigurationSection obiektu jako pojedynczą sekcję do zapisu w pliku. (Odziedziczone po ConfigurationSection)
SerializeToXmlElement(XmlWriter, String)	Zapisuje zewnętrzne tagi tego elementu konfiguracji do pliku konfiguracji po zaimplementowaniu w klasie pochodnej. (Odziedziczone po ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)	Ustawia właściwość na określoną wartość. (Odziedziczone po ConfigurationElement)
SetReadOnly()	IsReadOnly() Ustawia właściwość dla ConfigurationElement obiektu i wszystkich podelementów. (Odziedziczone po ConfigurationElement)
ShouldSerializeElementInTargetVersion(ConfigurationElement, String, FrameworkName)	Wskazuje, czy określony element powinien być serializowany, gdy hierarchia obiektów konfiguracji jest serializowana dla określonej wersji docelowej platformy .NET. (Odziedziczone po ConfigurationSection)
ShouldSerializePropertyInTargetVersion(ConfigurationProperty, String, FrameworkName, ConfigurationElement)	Wskazuje, czy określona właściwość powinna być serializowana, gdy hierarchia obiektów konfiguracji jest serializowana dla określonej wersji docelowej programu .NET Framework. (Odziedziczone po ConfigurationSection)
ShouldSerializeSectionInTargetVersion(FrameworkName)	Wskazuje, czy bieżące wystąpienie ConfigurationSection powinno być serializowane, gdy hierarchia obiektów konfiguracji jest serializowana dla określonej wersji docelowej programu .NET Framework. (Odziedziczone po ConfigurationSection)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)	Modyfikuje obiekt, ConfigurationElement aby usunąć wszystkie wartości, które nie powinny być zapisywane. (Odziedziczone po ConfigurationElement)

Zobacz też

• CustomError
• CustomErrorCollection
• CustomErrorsMode