CustomErrorsSection-Klasse

Konfiguriert benutzerdefinierte ASP.NET-Fehlermeldungen.

Syntax

class CustomErrorsSection : ConfigurationSectionWithCollection

Methoden

In der folgenden Tabelle werden die Methoden aufgelistet, die von der CustomErrorsSection-Klasse verfügbar gemacht werden.

Name Beschreibung
Add (Hinzufügen) (Geerbt von ConfigurationSectionWithCollection.)
Clear (Geerbt von ConfigurationSectionWithCollection.)
Get (Geerbt von ConfigurationSectionWithCollection.)
GetAllowDefinition (Geerbt von ConfigurationSection.)
GetAllowLocation (Geerbt von ConfigurationSection.)
Remove (Geerbt von ConfigurationSectionWithCollection.)
RevertToParent (Geerbt von ConfigurationSection.)
SetAllowDefinition (Geerbt von ConfigurationSection.)
SetAllowLocation (Geerbt von ConfigurationSection.)

Eigenschaften

In der folgenden Tabelle sind die Eigenschaften aufgeführt, die von der CustomErrorsSection-Klasse verfügbar gemacht werden.

Name Beschreibung
CustomErrors Ein Array von CustomError-Werten, die ASP.NET benutzerdefinierten Fehler angeben.
DefaultRedirect Ein erforderlicher Wert mit nicht benötigtem Lese-/Schreibzugriff string, der den Standardpfad einer HTTP-Fehlermeldungsdatei oder die URL einer Fehlermeldung enthält. Dieser Wert wird von der Redirect Eigenschaft neu erstellter CustomError-Objekte geerbt.
Location (Geerbt von ConfigurationSection.) Eine Schlüsseleigenschaft.
Mode Eine Lese-/Schreibaufzählung sint32, die angibt, ob benutzerdefinierte oder Standardfehlerseiten lokal oder remote angezeigt werden. Die möglichen Werte werden weiter unten im Abschnitt Hinweise aufgeführt.
Path (Geerbt von ConfigurationSection.) Eine Schlüsseleigenschaft.
SectionInformation (Geerbt von ConfigurationSection.)

Unterklassen

Diese Klasse enthält keine Unterklassen.

Hinweise

Die von der CustomErrorsSection-Klasse dargestellten benutzerdefinierten Fehler sind spezifisch für ASP.NET und befinden sich im <system.web>-Abschnitt der Web.config-Datei. Jeder dieser Fehler wird durch eine Instanz der CustomError-Klasse dargestellt.

Die benutzerdefinierten Fehler, die durch die HttpErrorsSection-Klasse dargestellt werden, beziehen sich auf IIS 7 und befinden sich im <system.webServer>-Abschnitt der ApplicationHost.config-Datei. Jeder dieser Fehler wird durch eine Instanz der HttpErrorElement-Klasse dargestellt. Die Integration von ASP.NET mit IIS in IIS 7 hat diese Namensänderung erforderlich gemacht.

In der folgenden Tabelle werden die verschiedenen möglichen Werte für die Mode-Eigenschaft angezeigt. Der Standardwert ist 0 (RemoteOnly).

Wert Schlüsselwort Beschreibung
0 RemoteOnly Die Standardmäßige ASP.NET Fehlerseite wird lokalen Benutzern angezeigt. Remotebenutzer erhalten eine benutzerdefinierte Fehlerseite, wenn eine definiert ist. Wenn keine benutzerdefinierte Fehlerseite für den empfangenen Fehler definiert ist, wird eine IIS-Fehlerseite angezeigt.
1 On Eine benutzerdefinierte ASP.NET benutzerdefinierte Fehlerseite wird sowohl für lokale als auch für Remotebenutzer angezeigt.
2 Off Die Standardmäßige ASP.NET Fehlerseite wird sowohl für lokale als auch für Remotebenutzer angezeigt.

Beispiel

Im folgenden Beispiel wird die DefaultRedirect-Eigenschaft auf „CustomError.htm“ und die Mode-Eigenschaft auf On gesetzt.

' 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_

Vererbungshierarchie

ConfigurationSection

ConfigurationSectionWithCollection

CustomErrorsSection

Anforderungen

type Beschreibung
Client IIS 7.0 unter Windows Vista
IIS 7.5 unter Windows 7
IIS 8.0 unter Windows 8
IIS 10.0 unter Windows 10
Server IIS 7.0 unter Windows Server 2008
- IIS 7.5 unter Windows Server 2008 R2
IIS 8.0 auf Windows Server 2012.
- IIS 8.5 unter Windows Server 2012 R2
IIS 10.0 auf Windows Server 2016.
Produkt - IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0
MOF-Datei WebAdministration.mof

Weitere Informationen

ConfigurationSectionWithCollection-Klasse
CustomError-Klasse
HttpErrorElement-Klasse
HttpErrorsSection-Klasse

  • Last updated on